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9。 向 服务 组 件 架 构 案例 实战 指 南 \ ) 


Cloud 微 服务 架构 为 主线 
以 案例 讲述 Spring Cloud 的 常用 组 件 
轻松 掌握 基于 Spring Cloud 微 服务 架构 的 开发 技术 
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本 书 以 Spring Cloud 微服 务 架构 为 主线 ， 依 次 通过 案例 讲述 Spring Cloud 的 常用 组 件 。 看 完 本 书后 ， 大 
家 会 比较 熟悉 基于 Spring Cloud 微服 务 架构 的 开发 技术 。 

本 书 分 为 11 章 , 内 容 包 括 Spring Boot 微服 务 入 门 、Spring Data 连接 数据 库 ` Eureka 服务 治理 框架 、Ribbon 
负载 均衡 组 件 、HyStrix 服务 容错 组 件 、Feign 服务 调用 框架 、Zuul 网 关 组 件 、 用 Spring Cloud Config 搭建 配 
置 中 心 、 消 息 机 制 与 消息 驱动 框架 、 微 服务 健康 检查 与 服务 跟踪 ， 最 后 给 出 一 个 SpringBoot 开发 Web 的 实战 
案例 。 
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阅读 本 书 的 文字 ， 这 样 能 更 高 效 地 掌握 Spring Cloud 微服 务 开发 技巧 。 
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干 军 易 得 ， 一 将 难 求 。 在 软件 开发 行业 ， 与 高 级 程序 员 相 比 ， 架 构 师 能 拿 到 更 高 的 工资 ,为 
什么 呢 ? 因为 架构 师 更 需要 解决 “负载 均衡 ”“ 服 务 治理 ”与 “ 限 流 降低 ”等 软件 架构 领域 的 问题 。 
如 果 架 构 方面 的 问题 没 处 理 好 , 那么 模块 间 的 耦合 度 可 能 会 非常 高 ,从 而 使 项 目 在 经 过 几 个 迭代 版 
本 后 很 难 维护 。 这 还 算 小 事 ， 如 果 系 统 架 构 失 当 ， 部 署 到 生产 环境 后 ， 就 非常 有 可 能 无 法 适应 高 并 
发 量 的 访问 需求 。 

相 比 于 高 级 程序 员 ， 升 级 到 架构 师 的 难度 会 比较 大 ， 这 是 因为 虽然 很 多 人 知道 架构 师 该 掌握 
的 技能 , 但 却 不 知道 该 通过 哪些 手段 来 提升 实践 技能 。 比 如 很 多 人 知道 负载 均衡 的 概念 和 相关 算法 ， 
但 掌握 架构 级 别 使 用 负载 均衡 组 件 的 人 并 不 多 , 而 掌握 负载 均衡 组 件 与 其 他 架构 组 件 (比如 网 关 组 
件 ) 相 整 合 从 而 发 挥 更 大 效用 的 人 就 更 少 了 。 

我 们 知道 ,在 Spring Cloud 的 诸多 组 件 里 ,包含 着 能 实现 各 种 架构 需求 的 组 件 , 比如 通过 Eureka 
组 件 能 实现 服务 治理 , 通过 Hystrix 能 实现 容错 保护 , 通过 Spring Cloud Stream 能 整合 消息 中 间 件 ， 
所 以 从 Spring Cloud 入 手 了 解 架 构 方面 的 技能 是 一 个 比较 有 操作 性 的 选择 。 

本 书 可 以 看 成 为 Spring Cloud 微服 务 组 件 架 构 案 例 实 战 指南 ， 站 在 架构 设计 的 角度 ， 从 “服务 
治理 ” “负载 均衡 ”“ 容 错 保护 ”“ 网 关 ” 和 “消息 通信 ”等 角度 向 大 家 逐一 介绍 Spring Cloud 中 
的 常用 组 件 。 

在 本 书 每 个 介绍 “架构 级 ”组 件 的 章节 中 ， 大 家 不 会 看 到 大 段 引 经 据 典 的 文字 ， 而 是 能 看 到 
有 实践 意义 的 案例 。 而且， 每 个 案例 均 配 有 视频 讲解 ， 大 家 能 很 快 在 自己 的 机 器 上 调试 通过 ( 免 去 
了 很 多 自己 试 错 的 时 间 ) ， 通 过 运行 这 些 案例 ， 读 者 能 快速 地 掌握 架构 级 别 相关 组 件 的 作用 和 一 般 
用 法 。 

我 们 知道 ， 在 系统 架构 体系 中 ， 往 往 会 把 多 个 组 件 整合 到 一 起 配套 使 用 ， 所 以 本 书 给 出 的 案 
例 更 注重 各 类 “整合 ”， 比 如 网 关 (Zuul) 与 负载 均衡 组 件 (Ribbon) 整合 ,或 服务 治理 (Eureka) 
和 日 志 组 件 〈Sleuth) 整合 ， 当 然 在 整合 的 时 候 不 能 乱 点 翅 爷 谱 ， 而 是 要 契合 企业 的 实际 需求 和 党 
规 用 法 。 而 且 ， 在 讲述 架构 级 Spring Cloud 组 件 的 时 候 ， 我 们 不 仅仅 停留 在 案例 代码 级 别 ， 大 家 更 
能 从 文字 性 说 明 的 字里行间 感受 到 架构 师 思 考 问题 的 方式 以 及 组 件 层 面 解决 实际 问题 的 架构 方案 。 

不 少 人 想 学 Spring Cloud 微服 务 架构 技术 ， 由 于 牵涉 到 “架构 ”,， 因 此 不 怎么 好 学 。 在 本 书 中 ， 
针对 Spring Cloud 里 的 每 个 常用 组 件 , 都 将 给 出 基于 案例 的 讲解 , 所 以 通过 本 书 学 习 Spring Cloud， 
大 家 不 会 觉得 特别 难 。 

读者 在 读 完 每 个 章节 后 ， 不 仅 可 以 了 解 相关 常用 组 件 的 用 法 ， 还 可 以 掌握 包含 在 具体 组 件 背 
后 的 架构 思想 〈 比 如 负载 均衡 或 高 可 用 ) ， 与 之 相对 应 ， 在 读 完 本 书后 ， 读 者 不 仅 能 感受 到 相关 微 
服务 组 件 整 合 后 给 项 目 带 来 的 好 处 ， 还 能 自己 动手 实践 基于 多 个 组 件 的 微服 务 架 构 。 总 之 一 句 话 : 
本 书 能 从 Spring Cloud 微服 务 架构 体系 入 手 ， 帮 助 读 者 高 效 地 升级 到 架构 师 。 

除了 在 掌握 Spring Cloud 技术 方面 会 对 大 家 有 所 帮助 , 在 升级 到 架构 师 的 道路 上 , 本 书 也 是 一 
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个 比较 好 的 助手 。 一 方面 , 本 书 作 者 有 实际 的 架构 师 经 验 (尤其 在 Spring Cloud 方面 ), 知道 Spring 
Cloud 里 哪些 知识 该 学 ， 哪 些 可 以 一 笔 带 过 ; 另 一 方面 ， 本 书 作 者 也 是 资深 培训 老师 和 资深 计算 机 
图 书 的 作家 ， 知 道 如 何 把 Spring Cloud (乃至 架构 ) 方面 的 知识 清晰 地 传授 给 读者 或 学 员 的 方法 。 

大 家 在 阅读 每 个 章节 的 时 候 ， 会 看 到 “ 精 悍 而 易 懂 ”的 案例 ， 在 案例 的 上 下 文中 ， 更 能 感受 
到 作者 在 用 心 与 大 家 交流 。 正 因 如 此 ， 读 者 能 高 效 地 读 完 并 理解 每 个 章节 的 内 容 ， 与 之 对 应 的 是 ， 
在 读 完 本 书后 ， 能 掌握 Spring Cloud 乃至 架构 层面 的 开发 技能 ， 再 进一步 ， 甚 至 能 承担 部 分 “初级 
架构 师 ” 的 工作 。 

本 书 内 容 


第 1 章 介绍 以 Maven 方式 开发 Spring Boot 项 目的 一 般 方式 ， 以 及 Spring Cloud 全 家 桶 里 各 个 
常用 组 件 的 作用 。 

第 2 章 讲 解 Spring Boot 通过 Spring Data 里 的 JPA 组 件 与 MySQL 数据 库 交 互 的 方式 ， 其 中 不 
仅 包括 查询 获取 数据 的 一 般 方法 ， 还 包括 通过 JPA 实现 一 对 一 、 一 对 多 和 多 对 多 关联 的 方法 。 

第 3~5 章 分 别 讲述 Spring Cloud 的 服务 治理 组 件 Eureka、 负 载 均衡 组 件 Ribbon 以 及 服务 容错 
处 理 组 件 Hystrix。 在 实际 项 目 中 ， 这 3 个 组 件 一 般 会 配套 使 用 。 在 本 书 中 ， 大 家 能 看 到 整合 使 用 
这 3 个 组 件 的 技巧 。 

第 6 章 讲 述 客户 端 调用 组 件 Feign， 这 个 组 件 能 封装 客户 端的 调用 细节 ， 从 而 能 进一步 解 耦合 
服务 调用 和 业务 逻辑 。 

第 7 章 讲 述 Zuul 网 关 ， 包 括 该 组 件 配置 路 由 的 做 法 及 其 过 滤器 的 使 用 技巧 。 

第 8~10 章 分 别 讲述 Spring Cloud Config 配置 管理 组 件 、Spring Cloud Bus 和 Spring Cloud Stream 
消息 管理 组 件 和 基于 Sleuth 的 微服 务 跟踪 组 件 ， 通 过 它们 ， 我 们 能 进一步 完善 微服 务 系统 的 架构 。 

在 最 后 一 章 里 ， 我 们 给 出 基于 Spring Cloud 的 若干 案例 ， 其 中 包括 在 Spring Boot 里 开发 Web 
旦 序 的 方式 、 在 Spring Boot 里 实现 身份 验证 和 权限 管理 的 技巧 ， 并 在 本 章 最 后 整合 诸多 组 件 ， 给 
出 一 个 相对 完整 的 案例 。 

本 书 下 载 资源 : https://www.cnblogs.com/JavaArchitect/p/10721237.html。 也 可 以 扫描 
下 面 的 二 维 码 下 载 。 


最 后 ， 感 谢 大 家 耐心 读 完 “ 前 言 ”， 如 果 大 家 再 进一步 用 心 看 完 本 书 的 所 有 内 容 ， 相 信 收 获 会 超出 你 
的 想象 。 本 人 邮箱 地址 为 hsm computer@163.com ， 博 客 园 的 技术 博客 地 址 为 
https//www.cnblogs.com/JavaArchitect/， 如 果 对 本 书 有 一 些 建 议 , 或 大 家 在 学 习 中 遇 到 问题 ,欢迎 一 起 讨论 。 


编者 
2019 年 3 月 


第 1 章 
| 


通过 SpingBoot 太 个 优 服务 sseessaaeaaaeieoaaaaaueioowaeaeeannt 1 


Spring Boot、Spring Cloud 与 微服 务 架 构 
1.1.1 通过 和 传统 架构 的 对 比 了 解 微 服务 的 优势 
1.1.2 Spring Boot、Spring Cloud 和 微服 务 三 者 的 关系 .… 
1.1.3 基于 Netflix OSS 的 Spring Cloud 的 常用 组 件 
通过 Maven 开发 第 一 个 Spring Boot 项 目 … 
1.2.1 Maven 是 什么 ， 能 带 来 什么 帮助 
1.2.2 ”通过 Maven 开发 Spring Boot 的 HelloWorld 程序 … 
1.2.3 ”Controller 类 里 处 理 Restful 格式 的 请 求 .… 
1.2.4 ” @SpringBootApplication 注解 等 价 于 其 他 3 个 注解 
1.2.5 通过 配置 文件 实现 热 部 署 
通过 Actuator 监控 Spring Boot 运 
1.3.1 准备 待 监控 的 项 目 
1.3.2 ”通过 /info 查看 本 站 点 的 自 定义 
1.3.3 ”通过 /health 查看 本 站 点 的 健康 信息 
1.3.4 通过 /metrics 查看 本 站 点 的 各 项 指标 人 
1.3.5 actuator 在 项 目 里 的 实际 用 法 . 


用 Spring Data 框架 连接 数据 库 
Spring Data 框架 概述 
Spring Data 通过 JPA 连接 MySQL 
2.2.1 连接 MySQL 的 案例 分 析 ..… 
2.2.2 使 用 yml 格 式 的 配置 文件 
2.2.3 通过 profile 文件 映射 到 不 同 的 运行 环境 . 
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3.1 了 解 Eureka 框架 


311 
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3.2 构建 基本 的 Eureka 应 用 
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32.2 
32.3 
3.2.4 
3.3 
3.3.1 
33.2 
33.3 
3.3.4 
3.3.5 
33.6 


3.4 Eureka 的 常用 配置 信息 .pe 


3.4.1 
3.4.2 
3.4.3 
3.4.4 


Eureka 能 干什么 
Eureka 的 框架 图 


搭建 Eureka 服务 器 
编写 作为 服务 提供 者 的 Eureka 客户 端 .. 
编写 服务 调用 者 的 代码 
通过 服务 调用 者 调用 服务 . 


编写 相互 注册 的 服务 器 端 代码 … 
服务 提供 者 只 需 向 其 中 一 台 服务 器 注册 .… 
修改 服务 调用 者 的 代码 .…… 
正常 场景 下 的 运行 效果 .. 
一 台 服务 器 宕 机 后 的 运行 效果 .… 


查看 客户 端 和 服务 器 端的 配置 
设置 心跳 检测 的 时 间 周 期 .. 
设置 自我 保护 模式 
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4.1.1 
4.1.2 
4.1.3 
4.1.4 


4.2 ”编写 基本 的 负载 均衡 程序 


4.2.1 
4.2.2 


4.3 Ribbon 中 重要 组 件 的 用 法 


4.3.1 
4.3.2 
4.3.3 


4.4 Ribbon 整合 Eureka 组件 
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基于 4 层 和 7 层 的 负载 均衡 策略 
硬件 层 和 软件 层 的 负载 均衡 方案 比较 
常见 的 软件 负载 均衡 策略 .… 
Ribbon 组 件 基本 介绍 .………… 


编写 服务 器 端的 代码 
编写 客户 端 调用 的 代码 


ILoadBalancer: 负载 均衡 器 接口 … 
IRule: 定义 负载 均衡 规则 的 接口 .. 
IPing: 判断 服务 器 是 否 可 用 的 接口 .. 


ee 59 


4.4.2 编写 Eureka 服务 器 
4.4.3 编写 Eureka 服务 提供 者 .…. 
4.4.4 在 Eureka 服 务 调 用 者 里 引入 Ribbon . 
4.4.5 重 写 IRule 和 IPing 接口 
4.4.6 ”实现 双 服 务 器 多 服务 提供 者 的 高 可 用 效果 
4.5 配置 Ribbon 的 常用 参数 
4.5.1 参数 的 影响 范围 
4.5.2 ”归纳 常用 的 参数 
4.5.3 在 类 里 设置 Ribbon 参数 .… pe 
Os ya | 
第 5 章 ”服务 容错 组 件 : HyStrix. 72 
5.1 在 微服 务 系统 里 引入 Hystrix 的 必要 性 
5.1.1 通过 一 些 算术 题 了 解 系统 发 生 错误 的 概率 .… 
5.1.2 ”用 通俗 方式 总 结 Hystrix 的 保护 措施 
5.2 ”通过 案例 了 解 Hystrix 的 各 种 使 用 方式 
5.2.1 准备 服务 提供 者 
5.2.2 ”以 同步 方式 调用 正常 工作 的 服务 … 


5.2.3 ”以 异步 方式 调用 服务 .ee 
5.2.4 调用 不 可 用 服务 会 启动 保护 机 制 … .78 
5.2.5 调用 Hystrix 时 引入 缓存 .80 


5.2.6 ”归纳 Hystrix 的 基本 开发 方式 


5.3 通过 Hystrix 实践 各 种 容错 保护 机 制 .82 
5.3.1 强制 开启 或 关闭 断路 器 .82 
5.3.2 ”根据 流量 情况 按 命令 组 开启 断路 器 .… .83 
5.3.3 ”降级 服务 后 的 自动 恢复 尝试 措施 .85 


5.3.4 ”线程 级 别 的 隔离 机 制 
5.3.5 ”信号 量 级 别 的 隔离 机 制 . 
5.3.6 ”通过 合并 批量 处 理 URL 请 
5.4 ”Hystrix 与 Eureka 的 整合 …………………… 
5.4.1 准备 Eureka 服务 器 项 目 
5.4.2 ”服务 提供 者 的 代码 结构 
5.4.3 ”在 服务 提供 者 项 目 里 引入 断路 器 机 制 .… 
5.4.4 在 服务 调用 者 项 目 里 引入 合并 请 求 机 制 … 
5 未 首相 后 wpa 
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6.1 通过 案例 快速 上 手 Feign 
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第 1 齐 


通过 Spring Boot 入 门 微服 务 


通过 微服 务 ， 架 构 师 能 有 效 地 降低 企业 级 应 用 里 各 模块 的 耦合 度 ， 从 而 能 给 企业 带 来 切实 的 
实惠 。 基 于 这 一 点 〈 当 前 还 有 其 他 好 处 ) ， 在 架构 级 别 ， 微 服务 得 到 了 广泛 的 重视 。 对 于 开发 者 来 
说 , 一 旦 具备 微服 务 方面 的 开发 和 设计 的 能 力 ,不 仅 能 让 自己 有 更 多 的 工作 机 会 , 更 能 让 自己 在 架 
构 方 面 更 加 资深 ， 从 而 让 自己 更 有 价值 。 

由 于 涉及 架构 ,因此 在 开发 微服 务 架 构 时 ,大 家 不 仅 要 “ 写 代码 ”, 还 要 会 设置 一 些 配置 “分 
布 式 服务 组 件 ” 的 配置 信息 。 听 上 去 并 不 容易 ,不 过 本 章 将 会 通过 简单 易 懂 的 文字 让 大 家 无 障碍 地 
通过 Spring Boot 入 门 “ 微 服务 ”， 并 以 此 为 起 点 ， 向 大 家 展示 企业 级 开发 中 “微服 务 架构 ”的 常 
用 组 件 。 


1.1 Spring Boot、Spring Cloud 与 微服 务 架 构 


和 传统 的 Spring MVC 框架 相 比 ， 通 过 使 用 基于 Spring Boot 的 开发 模式 ， 我 们 可 以 简化 搭建 
框架 时 配置 文件 的 数量 ， 从 而 提升 系统 的 可 维护 性 。 而 且 在 Spring Boot 框架 里 ， 我 们 还 能 更 方便 
地 引入 Spring Cloud 的 诸如 安全 和 负载 均衡 方面 的 组 件 。 可 以 这 样 说 , Spring Boot 架构 是 微服 务 的 
基础 ， 在 这 个 架构 里 ， 我 们 可 以 引入 Spring Cloud 的 诸多 组 件 ， 从 而 搭建 基于 微服 务 的 系统 。 

搞 明 白 这 3 个 相关 概念 的 关系 后 ， 我 们 能 知道 在 微服 务 方面 “该 学 什么 ”以 及 “该 怎么 学 ”， 
否则 大 家 可 能 无 法 把 微服 务 的 知识 点 有 效 地 整合 成 知识 体系 。 


1.1.1 ”通过 和 传统 架构 的 对 比 了 解 微服 务 的 优势 


从 图 1.1 中 ， 我们 能 看 到 一 个 传统 的 在 线 购物 网 站 的 基本 架构 。 
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订单 服务 [客户 服务 
产品 服务 评价 服务 
[优惠 券 服务 ] [其 他 服务 ] 


ce 
图 1.1 传统 在 线 购物 网 站 的 基本 架构 


用 户 在 前 端 页 面 上 的 操作 ， 会 被 转化 成 一 个 个 发 向 后 端 各 模块 的 请 求 ， 当 对 应 的 模块 处 理 请 
求 时 会 和 数据 库 交 互 。 比 如 用 户 在 前 端 页 面 输 入 关键 字 搜 索 商 品 , 这 个 请 求 会 被 定位 到 “产品 服务 ” 
模块 里 ， 该 模块 会 和 数据 库 交 互 ， 找 到 合适 的 商品 结果 后 返回 。 

在 实际 项 目 里 ， 为 了 应 付 高 并 发 的 访问 请 求 ( 大 家 可 以 想象 一 下 双 十 一 的 场景 ) ， 往 往 会 做 
分 布 式 部 署 ， 如 图 1.2 所 示 。 在 这 种 框架 里 ， 从 前 端 页 面 里 发 到 后 端的 大 量 请 求 会 被 负载 均衡 服务 
器 (比如 Nginx 或 Ribbon) 分 发 到 不 同 的 服务 器 处 理 ， 而 在 每 个 服务 器 里 ， 都 会 有 一 套 如 图 1.1 
所 示 的 服务 模块 。 如 果 再 有 必要 ,还 可 以 把 数据 库 做 成 集群 , 用 多 台数 据 库 服 务 器 分 担 高 并 发 的 压 
力 。 


前 


负载 均衡 的 服务 器 


Cs [sz2] [ 莫 他 站 点 ] 


1.2 ”基于 分 布 式 的 在 线 购物 网 站 的 架构 


从 实际 效果 上 来 看 ， 如 果 采 用 图 1.2 的 分 布 式 架构 ， 用 多 台 业 务 处 理 服 务 器 和 数据 库 服务 器 ， 
确实 能 满足 高 并 发 的 需求 。 不 过 根据 实践 经 验 ， 上 述 架 构 一 般 会 存在 如 下 问题 。 

。 第 一 ， 各 功能 模块 之 间 的 调用 关系 会 比较 复杂 ， 用 专业 的 话 来 说 就 是 耦合 度 比较 高 ， 一 个 
模块 的 修改 往往 会 影响 到 其 他 多 个 模块 ， 也 就 是 说 代码 比较 难 维护 。 

@ 第 二 ， 由 于 在 具体 的 每 台 机 器 上 是 集中 式 部 署 ， 因 此 稳定 性 不 强 ， 往 往 一 个 问题 会 导致 整 
个 系统 崩 演 。 即 使 采用 基于 分 布 式 的 主 从 郊 余 等 措施 ， 这 个 问题 也 无 法 得 到 根本 解决 。 

@ 第 三 ， 可 扩展 性 不 强 。 假 设 当前 的 并 发 量 是 每 秒 100 次 请 求 ， 目 前 用 2 台 服 务 器 即 可 ， 当 
业务 量 上 升 后 ， 每 秒 的 并 发 量 上 升 到 1000 次 后 ， 就 需要 再 扩展 服务 器 了 ， 这 时 很 不 便利 。 


和 上 述 架 构 相 比 ， 微 服务 (Microservice) 的 体系 结构 如 图 1.3 所 示 。 
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订单 服务 库存 服务 


Restful it 
|| En 
其 他 服务 


由 


一 
数据 库 


1.3 微服 务 架构 


从 图 1.3 我 们 能 看 到 ， 微 服务 模块 之 间 一 般 会 通过 Restful 格式 的 请 求 通信 ， 换 句 话说， 模块 
间 的 耦合 度 比较 低 ， 这 样 就 很 便于 在 任何 模块 里 变更 业务 需求 。 

而 且 ， 每 个 模块 都 具有 自己 的 数据 库 ， 也 就 是 说 ， 每 个 模块 都 能 独立 运行 ， 整 个 系统 的 扩展 
性 比较 强 ， 比 如 能 用 比较 小 的 代价 来 扩展 新 的 功能 模块 。 


1.1.2 ”Spring Boot、Spring Cloud 和 微服 务 三 者 的 关系 


微服 务 是 体系 架构 ， 或 者 说 是 模块 的 组 织 形式 ， 说 得 再 通俗 点 ， 如 果 我 们 用 “微服 务 架构 ” 
的 方式 组 装 业 务 模块 ， 那 么 整个 系统 就 能 具有 如 上 文 所 述 的 “高 扩展 性 ”和 “模块 间 低 耦 合 度 ” 的 

注意 ， 微 服务 是 一 个 抽象 的 概念 ， 它 有 不 同 的 实现 方式 ， 而 基于 Spring Boot 的 Spring Cloud 
是 当前 比较 流行 的 一 种 实现 微服 务 的 方式 。 

由 于 Spring 具备 IOC 的 特性 ， 因 此 通过 Spring 开发 出 来 的 模块 ， 它 们 之 间 的 耦合 度 非 常 低 ， 
这 同 微服 务 的 要 求 非常 相似 。 在 之 前 Spring 版 本 的 基础 上 ，Pivotal 团队 提供 了 一 套 全 新 的 Spring 
Boot 框架 。 

在 这 套 框 架 里 ， 开 发 者 可 以 嵌入 Web 服务 器 ， 比 如 Tomcat， 无 须 像 之 前 那样 把 项 目 文件 打包 

(假设 打包 成 War 文件 ) 并 部 署 到 Web 服务 器 上 , 而 且 Spring Boot 还 具备 自动 配置 的 功能 , 更 为 

便利 的 是 ， 通 过 定义 配置 文件 ， 开 发 者 还 能 “自动 监控 健康 ”基于 Spring Boot 框架 模块 的 各 项 运 
行 时 的 性 能 指标 。 总 之 ， 大 家 可 以 这 样 理解 ，Spring Boot 是 之 前 Spring 框架 的 升级 版 ， 通 过 之 后 
基于 代码 的 叙述 ， 我 们 更 能 详细 地 体会 到 Spring Boot 框架 的 优势 。 

我 们 可 以 通过 Spring Boot 在 单 台 机 器 上 搭建 实现 业务 功能 的 模块 ， 但 事实 上 实现 高 并 发 的 网 
站 项 目 一 般 有 “负载 均衡 ”“ 路 由 代理 ” “消息 服务 ”和 “流量 过 高 断路 ”等 需求 ， 而 这 些 需 求 能 
很 好 地 通过 Spring Cloud 这 套 框架 提供 的 组 件 得 到 解决 。 

讲 完 三 者 的 含义 后 ， 我 们 就 能 清晰 地 理 顺 这 三 者 的 关系 了 。 

@ 第 一 ， 微 服务 架构 能 给 项 目 带 来 便于 扩展 和 维护 的 优势 ， 从 而 能 给 公司 带 来 实 患 ， 这 也 是 

微服 务 比 较 热 门 的 原因 。( 有 好 处 了 别人 才 会 用 。) 
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@ 第 二 ， 通 过 Spring Boot 能 开发 微服 务 “ 单 机 版 ”的 功能 模块 。 即 使 是 单机 版 的 ， 由 于 在 
其 中 能 谈 入 Web 服务 器 (当然 还 有 其 他 升级 点 )， 因 此 和 传统 的 Spring 架构 相 比 ， 也 能 给 
开发 人 员 带 来 实际 的 便利 。 

@ 第 三 ,通过 基于 Spring Cloud 框架 的 实现 “负载 均衡 ”等 功能 的 组 件 ， 我 们 能 有 效 地 把 各 

“单机 版 ”的 功能 模块 整合 到 一 起 组 成 架构 。 在 这 套 架 构 里 ， 我 们 不 仅 能 得 到 微服 务 架构 
所 带 来 的 好 处 ， 由 于 引入 了 Spring Cloud 组 件 ， 因 此 我 们 更 能 满足 “高 并 发 访问 量 ”的 需 


1.1.3 基于 Netflix OSS 的 Spring Cloud 的 常用 组 件 


提 到 Spring Cloud， 我 们 就 不 得 不 先 提 一 下 Netflix。 这 家 公司 组 织 成 立 了 一 个 开源 社区 ， 名 为 
Netflix Open Source Software Center (Netflix OSS) 。 经 过 很 多 大 神 级 别 的 开发 者 共同 努力 ， 这 个 社 
区 推出 了 架构 ，Spring Cloud 就 是 其 中 之 一 。 

大 家 也 可 以 这 样 理解 ，Spring Cloud 是 各 种 支持 分 布 式微 服务 的 组 件 的 集合 ， 通 过 配套 使 用 其 
中 的 各 项 组 件 ， 开 发 者 能 以 “微服 务 ” 的 方式 构建 基于 分 布 式 部 署 的 系统 。 在 表 1.1 里 ， 我 们 能 看 
到 Spring Cloud 中 的 常用 组 件 。 


表 1.1 Spring Cloud 常用 组 件 归纳 表 


组 件 名 在 项 目 中 的 作用 
二 二 能 很 好 地 管理 提供 微服 务 的 各 项 模块 ， 比 如 通过 Eureka， 系 统 能 有 效 
地 发 现 新 注册 的 组 件 ， 并 把 它 加 入 到 集群 中 
i 能 把 高 并 发 的 请 求 有 效 地 分 发 到 已 注册 的 各 服务 节点 上 
i 像 保险 丝 ， 一 旦 请 求 多 到 会 让 系统 崩溃 ，Hystrix 就 会 自动 熔断 ， 这 样 
请 求 就 不 会 再 发 到 系统 里 ， 从 而 能 保护 系统 
ee 比如 能 过 滤 掉 一 些 非法 请 求 ， 也 能 提供 智能 路 由 功能 
消息 中 间 件 。 | 通过 诸如 这 类 的 消息 中 间 件 ， 各 模块 问 能 有 效 地 发 送 消息 
本 能 优化 调用 | 在 微服 务 框架 里 ， 模 块 间 一 般 是 通过 Rest 的 格式 来 通信 ， 通 过 Feign， 
Se 服务 的 框架 | 模块 间 能 更 便捷 地 调用 Rest 服务 
能 跟踪 微服 | 在 企业 级 应 用 里 ， 一 般 会 包含 多 个 模块 ， 而 一 个 请 求 往往 会 调用 多 个 
Steuth 务 的 调用 过 | 服务 模块 。 通 过 Steuth， 开 发 者 能 方便 地 看 到 服务 调用 的 流程 ， 从 而 
程 能 很 方便 地 定位 问题 
Spring 最 务 配 置 管 | 通过 它 能 很 好 地 管理 微服 务 框架 《或 是 集群) 中 的 诸多 配置 文件 
Cloud 理工 具 
Config 


表 1.1 讲述 的 一 些 组 件 ， 比 如 Ribbon 或 Hystrix 不 只 是 能 被 用 在 微服 务 领域 ， 在 其 他 的 高 并 发 
场景 下 也 能 用 到 。 由 此 我 们 能 体会 到 ， 上 述 组 件 构成 了 能 搭建 基于 Spring Cloud 微服 务 的 全 家 桶 ， 
开发 者 能 根据 实际 需求 选用 其 中 的 一 个 或 多 个 组 件 。 
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1.2 通过 Maven 开发 第 一 个 Spring Boot 项 目 


用 传统 Spring 框架 开发 项 目 ， 虽 然 各 项 目的 业务 功能 点 不 同 ， 但 是 它们 会 有 不 少 相同 的 配置 
文件 。 新 创建 一 个 Spring 项 目 时 ， 我 们 不 得 不 复制 这 些 配 置 文件 ， 对 架构 师 (或 高 级 开发 ) 来 说 ， 
这 种 “代码 粘贴 ”动作 是 需要 尽量 避免 的 。Spring Boot 能 有 效 地 解决 这 类 问题 。 

Spring Boot 没有 “和 颠覆 性 ”地 改变 Spring 框架 ， 而 是 通过 引入 Maven 和 “自动 化 配置 ”等 方 
式 来 简化 配置 文件 。 它 不 仅 能 让 开发 者 在 新 建 项 目 时 减少 配置 文件 方面 的 工作 量 , 还 能 进一步 降低 
项 目 中 类 和 jar 包 之 间 的 依赖 关系 , 它 的 价值 在 于 “能 减轻 程序 员 在 开发 和 配置 项 目 中 的 工作 量 ”。 


1.2.1 Maven 是 什么 ， 能 带 来 什么 帮助 


我 们 在 用 Eclipse 开发 项 目 时 ， 一 定 会 引入 支持 特定 功能 的 jar 包 ， 比 如 从 图 1.4 中 ,我们 能 看 
到 这 个 项 目 需要 引入 支持 mysql 的 jar 包 。 


图 Resource 
Builders | @ source | 区 Projects| BB Libraries | 0 Order and Export 
Java Build Path 


由 Cr Se IARs EE class folders on the build path: 

由 Java Compiler 田 国 nysql-connector-java-5. 1. 19-bin jar - D:\software\java y Add JARs 

由 Java Editor 由 BN EAR Libraries 
Javadoc Location ® BN JavakE 6.0 Generic Library A et orel Ths 

由 MyEclipse 由 B JRE System Library [JavaSE-1.6] Aad Yariable 
Project References 四 JSTL 1.2.1 Librery 


Run/Debug Settings -mh Yeb App Libreries Add Library. 
朵 Task Repository 


Add Class Folder... 


Add External Class Folder, 


图 1.4 在 项 目 里 引入 jar 包 的 示意 图 

从 图 1.4 中 我 们 能 看 到 ， 支 持 mysql 的 jar 包 是 放 在 本 地 路 径 里 的 ， 这 样 在 本 地 运行 时 自然 是 
没 问题 的 ， 但 要 把 这 个 项 目 发 布 到 服务 器 上 就 会 有 问题 了 ， 因 为 在 这 个 项 目的 .classpath 文件 已 经 
指定 mysql 的 jar 包 在 本 地 D 盘 下 的 某 个 路 径 中 ， 如 图 1.5 所 示 。 


ctor-java-5.1.19-bin.jar"/ 


图 1.5 指定 jar 路 径 的 classpath 文件 的 片段 


一 旦 发 布 到 服务 器 上 ， 项 目 依然 会 根据 .classpath 的 配置 从 DD 盘 下 的 这 个 路 径 去 找 ， 事 实 上 服 
务 器 上 是 不 可 能 有 这 样 的 路 径 和 jar 包 的 。 

我 们 也 可 以 通过 在 .classpath 里 指定 相对 路 径 来 解决 这 个 问题 ， 在 下 面 的 代码 里 ， 我 们 可 以 指 
定 本 项 目 将 引入 “本 项 目 路 径 /WebRootlib” 目 录 里 的 jar 包 。 

<classpathentry kind="lib" path="WebRoot/1ib/jar 包 名 .jar"/> 

这 样 做 ， 发 布 到 服务 器 时 ， 由 于 会 把 整个 项 目 路 径 里 的 文件 都 上 传 ， 因 此 不 会 出 错 。 但 这 样 
依然 会 给 我 们 带 来 不 便 ,比如 这 个 服务 器 上 我 们 部 署 了 5 个 项 目 ,它们 都 会 用 到 这 个 mysql 支持 包 ， 


6 | Spring Cloud 实战 


这 样 我 们 就 不 得 不 把 这 个 jar 包 上 传 5 次 。 再 扩展 一 下 , 如 果 5 个 项 目 里 会 用 到 20 个 相同 的 jar 包 ， 
那么 我 们 还 真 就 不 得 不 做 多 次 复制 。 如 果 我 们 要 升级 其 中 的 一 个 jar 包 ， 那 么 还 真 就 得 做 很 多 重复 
的 复制 粘贴 动作 。 

期 望 中 的 工作 模式 应 该 是 ， 有 一 个 “仓库 ”统一 放置 所 有 的 jar 包 ， 在 开发 项 目 时 ， 可 以 通过 
配置 文件 引入 必要 的 包 ， 而 不 是 把 包 复 制 到 本 项 目 里 。 这 就 是 Maven 的 做 法 。 

用 通俗 的 话 来 讲 ，Maven 是 一 套 Eclipse 的 插件 ， 它 的 核心 价值 是 能 理 顺 项 目 间 的 依赖 关系 ， 
具体 来 讲 ， 能 通过 其 中 的 pom.xml 配置 文件 来 统一 管理 本 项 目 所 要 用 到 的 jar 包 ， 在 项 目 里 引入 
Maven 插件 后 ， 开 发 者 就 不 必 手 动 添加 jar 包 了 ， 这 样 也 能 避免 因此 来 带 来 的 一 系列 问题 。 


1.2.2 ”通过 Maven 开发 Spring Boot 的 HelloWorld 程序 


在 这 个 案例 中 , 大 家 不 仅 可 以 理解 如 何 开 发 Spring Boot 的 程序 , 更 能 理解 Maven 的 一 般 用 法 。 


代码 \ 第 1 章 \MyFirstSpringBoot 视频 第 1 章 \ 通 过 Maven 开发 Spring Boot 的 
HelloWorld 程序 


第 一 步 ， 创 建 Maven 项 目 。 本 书 使 用 MyEclipse 作为 开发 环境 ， 在 其 中 已 经 引入 了 Maven 插 
件 ， 所 以 我 们 可 以 通过 “File” 一 “New” 菜 单 ， 直 接 创 建 Maven 项 目 ， 如 图 1.6 所 示 。 


Select a wizard 
Create a Naven Project 


口 Show A Wizards. 


图 1.6 在 MyEclipse 里 创建 Maven 项 目的 示意 图 


在 图 1.6 中 , 单 击 “Next” 按钮 后 ,会 见 到 如 图 1.7 所 示 的 界面 , 在 其 中 我 们 可 以 设置 Group Id 
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了 New Waven Project 


New Maven project 2 
Specify Archetype parameters 


Group Ta: [con springboot 
Mrtifact Id; lyFirstSpringBoot 

Vearsion; 0. 0. 1-SHAPSHOT 加 
Packsge com. springboot. NyFirstSpringBoot 
Properties available from archetype 


ane yalue 


图 1.7 设置 Maven 各 属性 的 示意 图 


其 中 ，Group Id 代表 公司 名 《〈 也 叫 组 织 名 ) ， 这 里 设置 成 “com.springBoot”; Artifact Id 是 项 
目 名 ; Version 和 Packag 采用 默认 值 。 一 般 来 说 ， 通 过 Group Id、Artifact Id 和 Version 就 能 定位 到 
唯一 的 jar 包 。 完 成 设置 后 ， 能 看 到 新 建 的 项 目 MyFirstSpringBoot， 如 图 1.8 所 示 。 
> NyFirstSprineBoot 
外 src/nain java 
src/test/java 
BN JRE System Library 


BN Naven Dependencies 
区 sre 

EB target 

加 pom. xml 


田 … 困 … 因 "… 田 … 田 


图 1.8 创建 好 的 Maven 项 目 示意 图 


第 二 步 , 改写 pom.xml。 当 我 们 创建 好 Maven 项 目 后 , 在 其 中 能 看 到 pom.xml 文件 。 在 Maven 
项 目 里 一 般 是 通过 pom.xml 来 指定 本 项 目的 基本 信息 以 及 需要 引入 的 jar 依赖 包 ， 关 键 代 码 如 下 : 


<groupId>com.springboot</groupId> 

<artifactId>MyFirstSpringBoot</artifactId> 

<version>0.0.1-SNAPSHOT</version> 

<packaging>jar</packaging> 

<name>MyFirstSpringBoot</name> 

<url>http://maven.apache.org</url> 

<dependencies> 

<dependency> 

<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
<version>1.5.4.RELEASE</version> 


PpOoEIANMAONDp 
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12 </dependency> 

13 <dependency> 

14 <groupId>junit</groupId> 

1 <artifactId>junit</artifactId> 
16 <version>3.8.1</version> 

by! <scope>test</scope> 

18 </dependency> 


19 </dependencies> 


其 中 ,第 1~4 行 的 代码 是 自动 生成 的 ,用 来 指定 本 项 目的 基本 信息 ,这 和 我 们 在 之 前 创建 Maven 
项 目 时 所 填 的 信息 是 一 致 的 。 

从 第 7~19 行 的 dependencies 属性 里 ， 我 们 可 以 指定 本 项 目 所 用 到 的 jar 包 ， 在 第 8 和 第 13 行 
分 别 通 过 两 个 dependency 来 指定 该 引入 两 类 jar 包 .其 中 ,第 8~12 行 指定 了 需要 引入 用 以 开发 Spring 
Boot 项 目的 名 为 spring-boot-starter-web 的 jar 的 集合 , 第 13~18 行 指定 了 需要 引入 用 以 单元 测试 的 
junit 包 。 

从 上 述 代码 中 ， 我 们 能 见 到 通过 Maven 管理 项 目 依赖 文件 的 一 般 方式 。 比 如 在 下 面 的 代码 片 
段 里 , 通过 第 2~4 行 的 代码 说 明 需 要 引入 org.springframework.boot 这 个 公司 组 织 (发 布 Spring Boot 
jar 包 的 组 织 ) 发 布 的 名 为 spring-boot-starter-web 的 一 套 支持 Spring Boot 的 jar 包 ， 而 且 通 过 第 4 
行 指定 了 引入 包 的 版 本 号 是 1.5.4.RELEASE。 


1 <dependency> 

2 <groupId> org.springframework.boot </groupId> 

3 <artifactId>spring-boot-starter-web</artifactId> 
4 
5 


<version>1.5.4.RELEASE</version> 
</dependency> 


这 样 一 来 ， 在 本 项 目 里 ， 我 们 就 不 用 再 手动 地 添加 jar 包 ， 这 些 包 实际 上 是 存放 在 本 地 的 jar 
包 仓库 里 的 ， 也 就 是 说 ， 在 项 目 里 是 通过 pom.xml 的 配置 来 指定 需要 引入 这 些 包 。 
第 三 步 ， 改写 Appjava。 在 创建 项 目 时 ， 指 定 的 package 是 com.springboot.MyFirstSpringBoot， 
在 其 中 会 有 一 个 Appjava， 我 们 把 这 个 文件 改写 成 如 下 样式 。 
1 package com.springboot.MyFirstSpringBoot; 
import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 


2 

3 

4 import org.springframework.web.bind.annotation.RequestMapping; 
号 import org.springframework.web.bind.annotation.RestController; 
6 
7 
8 


@RestController 
@SpringBootApplication 
9 Ppublic class App { 


10 @RequestMapping ("/HelloWorld") 

i Public String sayHello() { 

有 多 return "Hello World!"; 

3 } 

14 public static void main(String[] args) { 
1 SpringApplication.run(App.class, args); 
16 . 

下 

18 


由 于 是 第 一 次 使 用 Maven， 我 们 在 这 里 再 强调 一 次 ， 虽 然 我 们 没有 在 项 目 里 手动 地 引入 jar， 
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但 是 在 pom.xml 里 指定 了 待 引 入 的 依赖 包 ， 具 体 而 言 就 是 需要 依赖 org.springframework.boot 组 织 
所 提供 的 spring-boot-starter-web， 所 以 在 代码 的 第 2~5 行 里 ,我们 可 以 通过 import 语句 ， 使 用 
spring-boot-starter-web 〈 也 就 是 Spring Boot) 的 类 库 。 

在 第 8 行 里 ， 我 们 引入 了 人 @SpringBootApplication 注解 ， 以 此 声明 该 类 是 一 个 基于 Spring Boot 
的 应 用 。 

在 第 10~13 行 的 代码 里 ， 我 们 通过 @RequestMapping 指定 了 用 于 处 理 /HelloWorld 请 求 的 
sayHello 方法 ， 在 第 14 行 的 main 函数 里 ， 我 们 通过 第 15 行 的 代码 启动 了 Web 服务 。 

至 此 ， 我 们 完成 了 代码 编写 工作 。 启 动 MyFirstSpringBoot 项 目 里 的 Appjava， 在 浏览 器 里 输 
入 “http://localhost:8080/HelloWorld”。 

由 于 /HelloWorld 请 求 能 被 第 11~13 行 的 sayHello 方法 的 @RequestMapping 对 应 上 ， 所 以 会 通 
过 sayHello 方法 输出 “Hello World!” 的 内 容 ， 如 图 1.9 所 示 。 


| a http://localhost:8080/HelloWorld 


1.9 HelloWorld 程序 运行 效果 图 

从 这 个 程序 里 ， 我 们 能 体会 到 开发 Spring Boot 和 传统 Spring 程序 的 不 同 。 

第 一 , 在 之 前 的 Spring MVC 框架 里 , 我们 不 得 不 在 web.xml 中 定义 采用 Spring 的 监听 器 ， 而 
且 为 了 采用 @Controller 控制 嚣 类， 我 们 还 得 加 上 一 大 堆 配 置 ， 但 在 Spring Boot 里 ， 我 们 只 需要 添 
加 一 个 @SpringBootApplication 注解 。 

第 二 ， 我 们 往往 需要 把 传统 的 Spring MVC 项 目 发 布 到 诸如 Tomcat 的 Web 服务 器 上 ， 启 动 
Web 服务 器 后 我 们 才能 在 浏览 器 里 输入 请 求 查 看 运行 的 效果 ; 这 里 我 们 只 需 启动 Appjava 这 个 类 
即 可 达到 类 似 的 效果 。 


1.2.3 ”Controller 类 里 处 理 Restful 格式 的 请 求 


之 前 我 们 已 经 提 到 过 ， 微 服务 模块 间 一 般 是 通过 Restful 格式 的 请 求 来 交互 ， 在 表 1.2 里 ， 我 
们 能 看 到 各 种 Restful 请 求 的 格式 。 


表 1.2 常用 Restful 格式 请 求 的 功能 归纳 表 


Get /accounts 以 HTTP 里 的 get 协议 查询 所 有 的 account 对 象 
Post | /accounts 以 HTTP 里 的 post 协议 查询 所 有 的 account 对 象 
Get | /accounts/id 返回 指定 id 的 账户 ， 相 当 于 “ 查 指定 对 象 ” 

Put | /accounts/id 更 新 指定 id 的 账户 ， 相 当 于 “ 改 ” 

Delete | /accounts/id 删除 指定 id 的 账户 ， 相 当 于 “ 删 ” 


其 中 ，Get 等 都 是 基于 HTTP 协议 的 请 求 。 具 体 而 言 ， 如 果 我 们 指定 请 求 类 型 是 Get， 并 设置 
请 求 url 是 /accounts/123, 那么 我 们 就 能 得 到 id 是 123 的 账户 信息 , 如果 发 的 是 Get 类 型 的 /accounts， 
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十 
Er 


所 有 的 账户 。 

在 SpringBootRestfulDemo 案例 中 ， 我 们 将 向 大 家 演示 在 Spring Boot 里 编写 支持 Restful 格式 
请 求 的 服务 类 的 一 般 方法 ， 同 样 ， 这 里 我 们 用 Maven 来 创建 项 目 。 

代码 位 置 视频 位 置 

代码 \ 第 1 章 \SpringBootRestfulDemo 视频 \ 第 1 章 \Spring Boot Restful 效果 演示 


在 这 个 项 目 里 ， 我 们 用 和 刚才 MyFirstSpringBoot 一 样 的 方法 创建 Maven 项 目 ， 只 是 这 里 的 
artifactld 需要 填写 成 本 项 目的 名 字 SpringBootRestfulDemo 。 这 个 项 目的 pom.xml 和 
MyFirstSpringBoot 项 目 里 的 一 致 ， 同 样 是 引入 Spring Boot 的 依赖 包 。 在 这 个 项 目的 App.java 的 
main 函数 里 ， 我 们 同样 加 入 了 启动 代码 ， 如 下 所 示 。 

1 // 省 略 必要 的 package 和 import 代码 
// 同 样 通过 @SpringBootApplication 注解 来 说 明 本 类 是 启动 类 
@SpringBootApplication 
public class App { 

public static void main(String[] args) { 

SpringApplication.run(App.class, args); 


ANAMAWN 


} 

在 这 个 项 目 中 ， 我 们 需要 定义 描述 账户 信息 的 Account 类 ， 代 码 如 下 所 示 。 
1 package com.springboot.SpringBootRestfulDemo; 

2 public class Account { 

总 Private int id; 

4 Private String accountName; 

5 

6 


// 省 略 针对 id 和 accountName 这 两 个 属性 的 get 和 set 方法 
} 


在 RestfulController.java 里 ， 我 们 将 定义 处 理 各 种 Restful 格式 请 求 的 方法 ， 代 码 如 下 所 示 。 


1 “// 省 略 必要 的 Package 和 import 方法 

2 ”// 通 过 这 个 注解 说 明 本 控制 器 可 以 处 理 Restful 格式 的 请 求 

3  Q@RestController 

4 Public class RestfulController { 

B // 正 式 场景 里 ， 应 当 在 数据 表 里 存 储 账户 信息 ， 这 里 我 们 用 HashMap 演示 

6 static Map<Integer, Account> accounts = new HashMap< 

7 Integer, Account>(); 

8 // 如 果 是 Get 请 求 ， 而 且 请 求 格 式 是 /account， 则 将 调用 这 个 方法 

9 @RequestMapping (value = "/account", method = RequestMethod.GET) 

10 List<Account> getAccountList() // 返 回 所 有 的 账户 信息 

rit { return new ArrayList<Account>(accounts.values()); } 

U2 // 如 果 是 POST 请 求 ， 而 且 请 求 格式 是 /account， 则 将 调用 这 个 方法 

和 @RequestMapping (value = "/account", method = RequestMethod.POST) 
// 插 入 一 条 数据 ， 并 返回 OK 

14 String postAccount (@ModelAttribute Account account){ 

Ls accounts.put (account .getId(), account); 

16 return "OK"; 

17 } 

18 // 如 果 是 GET 请 求 ， 而 且 请 求 时 带 id 参数 ， 则 将 调用 这 个 方法 

19 @RequestMapping (value = "/account/{id}", method = RequestMethod.GET) 


20 Account getAccount (@PathVariable Integer id){ 
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2 //return accounts.get (id); 
22 // 在 项 目 中 ， 一 般 会 如 21 行 所 示 从 数据 源 里 得 到 数据 并 返回 
23 // 但 这 里 ， 由 于 没有 数据 源 ， 所 以 这 里 造 个 数据 返回 


24 Account account = new Rccount () 7 

25 account .setId(id) 7 

26 account .setAccountName ("Tom"); 

2 return account; 

28 } 

29 // 如 果 是 PUT 请 求 ， 而 且 请 求 时 带 id 参数 ， 则 将 调用 这 个 方法 

30 @RequestMapping (value="/account/{id}", method=RequestMethod.PUT) 
3 下 String putAccount (GPathVariable Integer id, @ModelAttribute 


Account account){ 


32 // 向 数据 源 插入 一 条 数据 并 返回 


33 accounts.put (id, account); 

34 return "OK"; 

3 } 

36 // 如 果 是 Delete 请 求 ， 而 且 请 求 时 带 id 参数 ， 则 将 调用 这 个 方法 
3 @RequestMapping (value="/account/{id}", method=RequestMethod.DELETE) 
38 String deleteUser (@PathVariable Integer id){ 

39 // 从 数据 源 里 删除 这 条 id 所 指向 的 账号 信息 

40 accounts .remove (id); 

41 return "OK"; 

42 } 

43 } 


在 上 述 代码 里 ， 我 们 在 每 个 方法 的 @RequestMapping 注解 里 ， 不 仅 指 定 了 触发 该 方法 的 url 请 
求 格式 ， 还 指定 了 能 触发 该 方法 的 请 求 类 型 。 

在 正式 的 项 目 里 , 我 们 是 从 数据 源 (比如 Account 数据 表 ) 里 获取 数据 ， 这 里 我 们 用 HashMap 
来 代替 数据 库 ， 所 有 的 增 、 删 、 改 、 查 都 是 针对 上 文 第 6 行 定义 的 accounts 对 象 。 

这 里 我 们 通过 url 的 形式 简易 演示 一 下 “Get” 形 式 请 求 的 运行 效果 。 启 动 Appjava 后 ， 在 浏 
览 器 里 输入 “http://localhost:8080/account/1”， 我 们 能 看 到 Json 格式 的 返回 效果 ， 如 图 1.10 所 示 。 


{"id":1,"accountName” :" Tom"} 


图 1.10 Get 请求 返 回 的 效果 图 


这 里 的 请 求 其 实 是 触发 了 第 20 行 的 getAccount 方 法 , 至 于 Post 等 其 他 格式 的 请 求 , 无 法 通过 
浏览 器 的 形式 简单 地 调用 ， 所 以 这 里 只 给 出 实现 代码 ， 在 后 文 里 ， 我 们 将 详细 地 给 出 调用 方法 。 


1.2.4”@SpringBootApplication 注解 等 价 于 其 他 3 个 注解 


Spring Boot 和 传统 的 Spring 框架 一 样 ， 是 通过 注解 来 降低 类 《〈 以 及 模块 ) 之 间 的 耦合 ， 在 其 
中 ，@SpringBootApplication 这 个 注解 用 得 比较 多 ， 因 为 我 们 一 般 用 它 来 启动 应 用 项 目 。 

事实 上 它 是 一 个 复合 注解 ， 等 价 于 @ComponentScan 、@SpringBootConfiguration 和 
人 @EnableAutoConfiguration 。 


ee @ComponentScan 继承 于 @Configuration, 用 来 表示 程序 启动 时 将 自动 扫描 当前 包 及 子 包 下 
的 所 有 类 。 
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ee @SpringBootConfiguration 表示 将 会 把 本 类 里 声明 的 一 个 或 多 个 以 @Bean 注解 标记 的 实例 
纳入 Spring 容器 中 。 
。 @EnableAutoConfiguration 用 来 表示 程序 启动 时 将 自动 地 装载 springboot 默认 配置 文件 。 


1.2.5 ”通过 配置 文件 实现 热 部 署 


如 果 我 们 每 次 在 修改 完 Spring Boot 里 的 Java 或 配置 文件 后 都 需要 重启 诸如 App.java 这 样 的 启 
动 类 才能 生效 ,那么 这 样 的 开发 效率 未 免 太 低 。 在 实际 的 开发 过 程 中 ,我 们 可 以 通过 修改 pom.xml 
的 方式 来 实现 热 部 署 。 
以 刚才 的 SpringBootRestfulDemo 项 目 为 例 , 为 了 实现 热 部 署 , 我 们 需要 把 pom.xml 修改 如 下 : 
<dependencies> 
其 他 代码 不 变 ， 只 需 添加 一 个 dependency 元 素 
<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-devtools</artifactId> 
<version>1.5.4.RELEASE</version> 
</dependency> 


其 他 代码 不 变 


</dependencies> 
当 我 们 在 pom.xml 添加 完 第 3~7 行 的 代码 后 ， 启 动 Appjava， 这 时 我 们 能 看 到 如 下 输出 。 
rE {"id":1,"accountName":"Tom"} 


注意 ， 此 时 别 停 服 务 ， 直 接 修改 getAccount 方法 ， 把 第 6 行 参数 修改 成 “Peter”， 如 下 所 示 。 


oawmewm 


1 @RequestMapping (value = "/account/{id}", method = RequestMethod.GET) 
2 Account getAccount (@PathVariable Integer id) { 
3 //return accounts.get (id); 
4 Account account = new Account (); 
5 account .setId(id); 
6 account .setAccountName ("Peter"); 
经 return account; 
8 
此 时 如 果 我 们 再 往 浏览 器 里 输入 http://localhost:8080/account/1， 那 么 输出 就 变 成 “Peter” 了 ， 
也 就 是 说 ， 无 须 重启 App 启动 类 ， 即 能 看 到 修改 后 的 效果 。 


1 {"id":1,"accountName":"Peter"} 


1.3 ”通过 Actuator 监控 Spring Boot 运行 情况 


当 我 们 把 Spring Boot 部 署 到 服务 器 之 后 ， 一 般 需 要 监控 微服 务 的 运行 情况 : 一 方面 ， 我 们 可 
以 据 此 分 析 和 排查 问题 ， 另 一 方面 ， 我 们 能 以 此 为 依据 优化 代码 。 

Spring Boot 里 提供 了 spring-boot-starter-actuator 模块 ， 引 入 该 模块 后 ， 我 们 能 实时 地 监控 微服 
务 的 部 署 和 运行 情况 , 从 而 能 减少 程序 员 编写 监控 系统 模块 所 用 的 工作 量 。 这 里 我 们 将 着 重 讲 一 下 
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常用 的 监控 指标 。 


1.3.1 准备 待 监控 的 项 目 


新 建 一 个 基于 Maven 的 名 为 SpringBootActuatorDemo 的 项 目 ， 启 动 后 ， 再 通过 actuator 来 监 
控 它 所 在 站 点 的 实时 情况 。 


代码 位 置 视频 位 置 
代码 \ 第 1 章 \SpringBootActuatorDemo 视频 \ 第 1 章 \ 通 过 Actuator 监控 项 目 
步骤 01 人 在 pom.xml 加 入 Spring Boot 和 actuator 的 依赖 包 ， 关 键 代码 如 下 : 
和 <dependencies> 
本 <dependency> 
3 <groupId>org.springframework.boot</groupId> 
4 <artifactId>spring-boot-starter-web</artifactId> 
5 <version>1.5.4.RELEASE</version> 
6 </dependency> 
7 <dependency> 
8 <groupId>org.springframework.boot</groupId> 
9 <artifactId>spring-boot-starter-actuator</artifactId> 
10 <version>1.5.4.RELEASE</version> 
半生 </dependency> 


12 </dependencies> 
其 中 ， 第 2~6 行 引入 的 是 Spring Boot 的 依赖 包 , 第 7~11 行 引入 的 是 actuator 的 依赖 包 ， 其 他 
代码 不 变 。 
步骤 024 在 Appjava 的 main 函数 里 ， 同 样 编 写 启动 Spring Boot 的 代码 。 


// 省 略 必 要 的 Package 和 import 代码 
@SpringBootApplication 
Public class Appt{ 
Public static void main( String[] args ){ 
// 启 动 Spring Boot 
SpringApplication.run (App.class, args); 
. 


oo auwmwwNP 


} 


步骤 034 在 src 目录 下 ， 编 写 包含 配置 信息 的 application.properties 文件 。 在 Spring Boot 的 
有 ， 我 们 一 般 把 配置 文件 放 在 这 个 目录 ， 如 图 1.11 所 示 。 
日 各 SpringBootkActuatorDeno 


日 -四 src/nain/java 
日 顶 com. springboot. SpringBootAd 


关 
了 J 
[re 


由 - 国 ip. java 


图 1.11 application.properties 文件 的 一 般 位 置 


application.properties 里 的 代码 如 下 所 示 。 


1 management.security.enabled=false 
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info.build.artifact=org.springframework.boot 
info.build.name=SpringBootActuatorDemo 
info.build.description=DemoActuator 
info.build.version=1.0 

其 中 ， 第 1 行 的 代码 用 来 指定 本 站 点 (运行 本 项 目的 站 点 ， 也 叫 节点 ) 无 须 验证 ， 这 样 我 们 
就 能 通过 浏览 器 看 到 一 些 actuator 给 出 的 监控 信息 ， 第 2~5 行 的 代码 用 来 指定 本 站 点 的 信息 。 

编写 完成 后 ， 通 过 App.java 启动 Spring Boot， 随 后 ， 我 们 就 能 通过 actuator 查看 监控 信息 。 


wo 上 mw N 


1.3.2 ”通过 /info 查看 本 站 点 的 自 定义 信息 


在 确保 启动 SpringBootActuatorDemo 的 情况 下 ， 在 浏览 器 里 输入 “http:Wlocalhost:808O/info”， 
能 看 到 如 下 输出 信息 : 

Tbaiaudns 

{"description":"DemoActuator", "name":"SpringBootActuatorDemo", 


"version":"1.0", "artifact":"org.springframework.boot"} 
3090] 


其 中 ， 第 2 行 的 输出 信息 和 我 们 在 application.properties 里 配置 的 站 点 信息 是 一 致 的 。 


1.3.3 ”通过 /health 查看 本 站 点 的 健康 信息 


输入 “http://localhost:8080/health”， 能 看 到 如 下 关于 本 站 点 健康 信息 的 输出 : 
i {wstatus": "UP", 
2 "diskSpace":{"status":"UP","total":143893012480, "free":73405607936, 
"threshold":10485760} 
Su 
在 第 1 行 里 ， 能 看 到 本 站 点 的 状态 是 “UP”， 也 就 是 启动 状态 ; 在 第 2 行 里 ， 能 看 到 关于 磁 
盘 使 用 量 的 情况 ， 总 体 来 说 ， 状 态 也 是 “UP”。 


1.3.4 ”通过 /metrics 查看 本 站 点 的 各 项 指标 信息 


输入 “http:Wlocalhost:8080/metrics”， 我 们 能 看 到 关于 本 站 点 内 存 使 用 量 、 线 程 使 用 情况 以 及 
垃圾 回收 等 信息 ， 大 致 输出 如 下 : 


"mem" :54530, 

"mem. free":7435, 
"processors":2, 
"instance.uptime":8862204, 
省 略 其 他 信息 

} 


比如 在 上 述 第 3 行 里 ， 我 们 能 看 到 空闲 内 存 的 值 。 这 里 的 指标 数 很 多 ， 我们 就 不 一 一 列 出 了 ， 
大 家 可 以 自己 看 一 下 。 总 结 起 来 ，/metrics 将 返回 如 下 种 类 的 信息 : 


aowm 必 wm 
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mem.*: 描述 内 存 使 用 量 的 信息 。 
heap.*: 描述 虚拟 机 堆 内 存 的 信息 。 
threads.*: 描述 线程 使 用 情况 的 信息 。 
classes.*: 描述 类 加 载 和 纯 载 的 信息 。 
gc.*: 用 来 描述 垃圾 回收 的 信息 。 
此 外 , 我 们 还 能 通过 具体 的 指标 名 查看 对 应 的 值 , 比如 输入 “http://localhost:8080/metrics/gc.*”， 
就 能 看 到 垃圾 回收 相关 指标 的 信息 ， 输 出 如 下 : 


下 {"gc.copy.count":60,"gc.copy.time":206,"gc.marksweepcompact .count" : 
2，"gc.marksweepcompPact .time":97} 


1.3.5 ”actuator 在 项 目 里 的 实际 用 法 


除了 刚才 给 出 的 用 法 外 ， 我 们 还 能 通过 /env 查看 当前 站 点 的 环境 信息 ， 能 通过 /mappings 来 查 
看 当前 站 点 的 Spring MVC 控制 器 的 映射 关系 ， 能 通过 /beans 来 查看 当前 站 点 中 的 bean 信息 。 

不 过 在 项 目 里 ， 我 们 一 般 不 是 通过 浏览 器 来 查看 ， 而 是 会 通过 代码 来 定时 检测 ， 再 进一步 ， 
一 旦 当 检 测 到 的 数据 低 于 预期 就 自动 发 警告 邮件 。 在 本 书 的 后 继 部 分 ,将 给 出 这 种 做 法 的 实际 案例 。 
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这 章 我 们 不 仅 讲 述 了 微服 务 和 传统 体系 架构 的 差别 ， 还 通过 了 一 些 基 本 的 Spring Boot 案例 让 
大 家 感性 地 认识 了 微服 务 。 通 过 这 些 案例 ， 大 家 不 仅 可 以 了 解 到 Spring Boot 的 基本 语法 ， 还 能 党 
担 实际 项 目 中 和 Spring Boot 密切 相关 的 一 些 技能 ， 比 如 热 启 动 、 如 何在 控制 器 类 里 处 理 Restful 格 
式 的 请 求 和 通过 actuator 监控 微服 务 站 点 的 方法 等 。 

通过 本 章 ， 大 家 能 对 Spring Boot 有 一 个 初步 的 了 解 ， 这 也 是 大 家 继续 通过 本 书后 继 章 节 了 解 
Spring Cloud 微服 务 的 基础 。 请 大 家 注意 ， 微 服务 是 一 个 框架 ， 所 以 大 家 在 后 继 学 习 时 ， 不 仅 要 专 
注 具 体 的 实现 代码 ， 务 必 还 要 关注 微服 务 的 框架 本 身 ， 比 如 微服 务 模块 间 如 何 实现 “负载 均衡 ”以 
及 多 个 微服 务 模 块 构建 成 集群 的 方式 。 


第 章 


用 Spring Data 框架 连接 数据 库 


和 JDBC 一 样 ， 通 过 Spring Data 框架 里 的 JPA 组 件 ， 我 们 也 能 用 比较 相似 的 方法 无 差别 地 访 
问 不 同类 型 数据 库 。 

这 种 “屏蔽 ”的 便利 性 和 Spring 里 “ 解 耦合 ”的 理念 是 一 脉 相 承 的 , 具体 来 说 , 通过 Spring Data 
框架 ,我 们 能 轻易 地 解 看 合 业务 逻辑 和 底层 的 数据 库 实现 逻 辑 ， 这 种 “ 解 看 合 ”的 特性 能 从 很 大 程 
度 上 提升 系统 的 扩展 性 与 可 维护 性 ， 使 得 我 们 能 用 很 小 的 代码 更 换 系统 的 数据 存储 容器 。 

而 且 ，JPA 组 件 也 能 起 到 ORM 里 映射 的 效果 ， 也 就 是 说 ， 通 过 它 ， 我 们 还 能 比较 容易 地 实现 
业务 中 “一 对 一 ”“ 一 对 多 ”和 “多 对 多 ”的 效果 。 


2.1 Spring Data 框架 概述 


Spring Data 是 一 个 能 简化 数据 库 访问 的 开源 框架 , 通过 该 框架 里 的 ORM 特性 , 我 们 能 比较 快 
捷 地 编写 对 数据 库 层 的 访问 逻辑 。 由 于 它 也 是 Spring 家 族 的 ,因此 它 和 Spring Boot 乃至 Spring Cloud 
有 着 天 然 的 亲近 性 。 

从 图 2.1 中 ， 我 们 能 看 到 Spring Data 框架 在 项 目 里 所 起 到 的 作用 ， 通 过 它 ， 程 序 员 能 更 关注 
于 企业 的 核心 价值 一 一 业务 实现 ， 从 而 可 以 不 必 过 多 地 关注 业务 数据 在 数据 库 层 的 存储 和 读 取 细 
节 ， 这 种 解 耦合 的 便利 性 无 疑 将 提升 系统 代码 的 可 维护 性 。 
在 表 2.1 中 , 我 们 归纳 了 一 些 常 见 的 子 项 目 以 及 所 对 应 的 功能 。 不 过 在 实际 项 目 里 , 我 们 用 得 
比较 多 的 还 是 JPA 组 件 。 
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业务 层 代码 


Spring Data 框 架 


SS 


这 层 是 子 项 目 A Document Key-Value 


具体 的 数据 库 |DB NongoDB Redis 
图 2.1 Spring Data 框架 在 项 目 里 的 示意 图 


表 2.1 Spring Data 常用 子 项 目 功能 归纳 表 
子 项 目 名 功能 
JPA 支持 对 传统 数据 库 的 连接 操作 
Document 能 支持 NoSQL， 比 如 MongoDB 


能 支持 Key-Value 类 型 的 数据 库 ， 比 如 Redis 
能 支持 Hadoop 的 MapReduce 特性 
能 支持 Neo4j 图 形 数据 库 


2.2 Spring Data 通过 JPA 连接 MySQL 


JPA (Java Persistence API) 是 一 套数 据 库 持久 层 映 射 的 规范 ， 我 们 比较 熟悉 的 Hibernate 框架 
就 是 基于 这 套 规范 实现 的 ， 也 就 是 说 ， 它 们 两 者 的 语法 和 开发 方式 非常 相似 。 
这 里 ， 我 们 将 通过 Spring Data 里 的 JPA 实现 组 件 来 开发 针对 MySQL 数据 库 的 各 种 操作 。 


2.2.1 连接 MySQL 的 案例 分 析 


这 里 我 们 将 实现 通过 JPA 连接 并 访问 MySQL 数据 库 的 整个 流程 。 


代码 \ 第 2 章 \SpringBootJPAMySQLDemo 视频 \ 第 2 章 \Spring Boot 连接 MySQL 数据 库 
1. 创建 数据 表 ， 构 建 Maven 项 目 


我 们 在 MySQL 里 创建 一 个 名 为 springboot 的 数据 库 ， 在 其 中 创建 一 个 名 为 student 的 表 ， 结 
构 如 表 2.2 所 示 。 


表 2.2 student 表 结 构 的 说 明 


score float 成 绩 


字段 名 类 型 含义 
id Varchar 主键 ,学 号 
| name Varchar 姓名 | 
age Varchar 年 龄 | 
| 
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创建 完 表 之 后 ， 我 们 再 创建 一 个 名 为 SpringBooUPAMySQLDemo 的 Maven 类 型 的 项 目 。 
2. 在 pom.xml 里 配置 要 用 到 的 包 
本 项 目 中 pom.xml 的 关键 代码 如 下 ， 在 其 中 将 指定 本 项 目 要 用 到 的 jar 包 。 


1 / /省略 描述 项 目 名 部 分 的 配置 代码 

<parent> 

3 <groupId>org.springframework.boot</groupId> 

4 <artifactId>spring-boot-starter-parent</artifactId> 

3 <version>1.5.6.RELEASE</version> 

6 </parent> 

<dependencies> 

8 <dependency> 

9 <groupId>org.springframework.boot</groupId> 

10 <artifactId>spring-boot-starter-web</artifactId> 

14 </dependency> 

2 <dependency> 

3 <groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-jpa</artifactId> 

14 </dependency> 

15 <dependency> 

16 <groupId>mysql</groupId> 

入 <artifactId>mysql-connector-java</artifactId> 

18 <version>5.1.3</version> 

19 </dependency> 


20 / /省略 描述 junit 依赖 包 的 代码 

2 </dependencies> 

在 第 2~6 行 中 ， 我 们 用 parent 标签 来 配置 各 子 模块 将 要 依赖 的 通用 依赖 包 ， 也 就 是 各 子 模块 
都 要 用 到 的 jar 包 。 注 意 ， 这 里 的 版 本 是 1.5.6.RELEASE。 

在 我 们 引入 了 第 8~11 行 的 依赖 包 后 ， 我 们 就 可 以 把 本 项 目 配置 成 Spring MVC 了 ， 比 如 通过 
@RestController 来 定义 控制 器 。 注 意 ， 在 第 5 行 里 ， 我 们 已 经 定义 了 父 类 依赖 包 的 版 本 号 ， 这 里 
就 不 必 再 重复 定义 了 。 

在 第 12~14 行 中 ， 我 们 引入 了 Spring data jpa 所 必需 的 依赖 包 ， 其 实 就 是 所 必需 的 jar 文件 。 
在 第 15 到 19 行 中 ， 引 入 了 mysql 的 驱动 包 。 

在 本 项 目 里 用 到 的 jar 包 都 存在 于 本 地 Maven 仓库 里 ， 一 旦 在 本 项 目的 pom.xml 里 指定 了 要 
用 到 哪些 jar 包 ， 就 将 根据 具体 指定 的 groupId 和 artifactId 引用 本 地 仓库 里 对 应 的 包 。 

比如 本 机 的 maven 本 地 仓库 的 路 径 是 C:\Documents and Settings\Administrator\.m2\repository， 
而 在 pom.xml 里 配置 mysql 依赖 包 的 代码 如 下 : 

1 <groupId>mysql</groupId> 

2 <artifactIid>mysql-connector-java</artifactId> 

3 <version>5.1.3</version> 
那么 本 项 目 就 会 引用 Maven 本 地 仓库 路 径 \mysql\mysql-connector-java\5.1.3 目录 下 的 jar 包 ， 如 图 
2.2 所 示 。 其 中 ， 路径 中 的 mysql 和 groupId 相 一 致 ,mysql-connector-java 和 artifactId 相 一 致 ，5.1.3 
和 version 相 一 致 。 
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mysql-connector-. . 

SHA 文件 修改 日 期 : 2018-1-24 21:45 
1 更 大 小 : 631 到 


图 2.2 Maven 里 被 引用 的 jar 实际 位 置 示意 图 


同 理 ， 大 家 可 以 找到 本 项 目 引用 到 的 jpa 包 的 实际 位 置 。 

如 果 在 本 地 仓库 里 找 不 到 所 需要 的 jar 包 ， 那 么 Maven 会 自动 到 远 端 仓 库 去 下 载 jar 包 放 置 到 
本 地 仓库 ， 比 如 本 项 目 里 用 到 的 spring-boot-starter-web 版 本 是 1.5.6.RELEASE， 如 果 本 地 没有 ， 
大 家 还 能 看 到 从 远 端 仓库 (一般 是 一 个 能 提供 各 种 Maven 包 的 网 站 ) 下 载 的 这 个 过 程 。 


3. 编写 启动 程序 和 控制 器 类 


DataServerAppjava 的 代码 如 下 ， 在 其 中 的 第 5 行 里 ， 我 们 编写 了 启动 代码 。 不 过 请 注意 ， 它 
是 放 在 jpademo 这 个 package 里 的 。 


1  Q@SpringBootApplication 

2 public class DataServerApp{ 

这 Public static void main( String[] args ) 

和 { 

SpringApplication.run(DataServerApp.class, args); 
6 

7 


在 studentController 里 ， 我 们 放置 了 控制 器 部 分 的 代码 ， 在 其 中 我 们 通过 @RequestMapping 注 
解 来 指定 request 请 求 和 待 调用 方法 的 对 应 关系 。 


1 ”QRestController // 用 这 个 注解 说 明 该 类 是 控制 器 

2  @RequestMapping (value = "/students")// 指 定 基础 路 径 

3 public class studentController { 

4 eautowired // 将 自动 引入 studentService 

5 Private StudentService studentService; 

6 @RequestMapping (value = "/find/name/{name}") 

3 public List<Student> getStudentByName (@PathVariable String name) 
8 List<Student> students = studentService.findByName (name); 


9 return students; 

10 } 

3 @RequestMapping (value = "/nameAndscore/{name}/{score}" ) 

和 Public List<Student> findByNameAndScore (@PathVariable String name, 
@PathVariable float score) { 

13: List<Student> students = studentService.findByNameAndScore (name, 
score); 

14 return students; 

ii 

16 } 


在 第 7~10 行 里 ， 定 义 了 将 被 /find/name/{name} 格 式 url 触发 的 getStudentByName 方法 ， 其 中 
是 调用 service 类 的 方法 ， 返 回 指定 name 的 学 生 信息 。 


sbogseudssw 


在 第 11~15 行 里 ， 我 们 定义 了 可 以 被 “/nameAndscore/{name}/{score} ”这 种 url 格式 触发 的 
findByNameAndScore 方法 , 在 其 中 , 同样 是 通过 调用 service 层 的 方法 返回 指定 name 和 score 的 学 
生成 绩 。 

在 前 文 里 已 经 提 到 ，@SpringBootApplication 注解 包含 了 @ComponentScan， 通 过 后 者 这 个 注 
解 ， 我 们 能 设置 Spring 容器 的 扫描 范围 。 如 果 不 设置 ， 默认 的 扫描 范围 是 本 包 (也 就 是 jpademo) 
以 及 它 的 子 目录 。 

这 里 我 们 需要 让 容器 扫描 带 有 @RestController 的 studentController 类 并 把 它 设置 成 控制 器 类 ， 
如 果 把 控制 器 类 和 Appjava 类 设置 成 平 级 ， 那 么 容器 会 无 法 识别 这 个 控制 器 ， 这 就 是 为 什么 把 控 
制 器 类 包含 在 jpademo 子 目 录 里 的 原因 。 

同 理 ， 后 面 将 要 讲述 的 StudentServicejava 类 ， 由 于 出 现 了 @Autowired 注解 ， 因 此 也 希望 被 
容器 扫描 到 ， 所 以 我 们 同样 需要 把 该 类 放 在 jpademo 的 子 目录 里 。 

4. 编写 Service 类 


在 StudentService.java 里 ， 我 们 编写 提供 业务 服务 的 代码 ， 上 文 里 已 经 提 到 ， 为 了 也 能 让 容器 
扫描 到 它 ， 需 要 把 它 放 在 jpademo.servcie 包 ( 处 于 jpademo 的 子 目 录 中 ) 里 ， 代 码 如 下 : 


1 package jpademo.service; 


2 ”省 略 必要 的 import 代码 

3 ”QService// 自 动 注册 到 容器 里 

4 public class StudentService { 

5 QAutowired // 自 动 引 入 Repository 类 

6 Private StudentRepository stuRepository; 

/ /根据 name 查找 

8 public List<Student> findByName (String name){ 

9 // 调 用 stuRepository 里 的 对 应 方法 

10 return stuRepository.findByName (name); 

4 

12 // 根 据 name 和 score 查找 

| public List<Student> findByNameAndScore (String name,float score){ 
14 // 同 样 也 是 调用 stuRepository 里 的 对 应 方法 

有 return stuRepository.findByNameAndScore (name, Score) 7 
16 } 

eh 


这 个 类 里 提供 了 两 种 服务 方法 ， 第 8 行 的 findByName 方法 实现 了 根据 名 字 搜 索 的 功能 ， 第 
13 行 的 findByNameAndScore 方法 实现 了 根据 名 字 和 分 数 搜索 的 功能 。 在 这 两 个 方法 里 , 都 是 调用 
StudentRepository 类 型 的 stuRepository 对 象 里 的 方法 来 实现 功能 的 。 

5. 编写 Repository 类 

在 JPA 里 ， 一 般 是 在 Repository 类 放置 连接 数据 库 的 业务 代码 ， 它 的 作用 有 些 类 似 DAO。 这 
里 我 们 将 在 StudentRepository 类 里 实现 在 刚才 service 层 里 调动 的 两 个 操作 数据 库 的 方法 。 

1 package jpademo.repository;// 同 样 放 入 jpademo 的 子 目 录 

2 ”省 略 必要 的 import 代码 

@Component 

4 ”// 注 意 这 是 一 个 继承 Repository 的 接口 
3 


public interface StudentRepository extends Repository<Student, Long>{ 
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6 // 通 过 Query 注解 定义 查询 语句 

7 Qouery (value = "from Student s where s.name=:name") 

8 List<Student> findByName (@Param("name") String name); 

9 //JPA 将 根据 这 个 方法 自动 拼装 查询 语句 

10 List<Student> findByNameAndScore (String name, float score); 
于 


这 里 大 家 会 看 到 一 个 比较 有 意思 的 现象 ,我 们 在 第 8 行 和 第 10 行 定 义 的 两 种 方法 都 没有 方法 
体 。 事 实 上 在 JPA 的 底层 实现 里 将 会 根据 方法 名 以 及 注解 自动 地 执行 查询 语句 并 返回 结果 。 

具体 而 言 ， 在 第 8 行 的 fndByName 方法 里 ， 将 会 执行 第 7 行 @Query 注解 所 带 的 基于 Student 
表 的 查询 语句 ， 并 以 List<Student> 的 形式 返回 结果 。 在 第 10 行 的 findByNameAndScore 方法 里 ， 
JPA 底层 将 解析 方法 名 , 以 Name 和 Score 这 两 个 字段 为 条 件 查询 Student 表 , 同样 以 List<Student> 
的 形式 返回 结果 。 

我 们 这 里 只 给 出 了 常用 的 通过 equals 查询 的 例子 ， 在 表 2.3 里 ， 我 们 能 看 到 JPA 支持 的 其 他 
常用 关键 字 。 


表 2.3 JPA 里 支持 的 常用 关键 字 列 表 
关键 字 方法 名 示例 等 价 的 where 条 件 
| Equals | fndBy 字 段 名 Equals 。 ”| where 字段 名 -参数 
And findBy 字段 1And 字段 2 where 字段 = 参数 1 and 字段 ?= 参数 2 
findBy 字段 10r 字段 2 where 字段 1= 参 数 1 or 字段 2= 参 数 2 


findBy 字段 名 Between where 字段 between 参数 1 and 参数 2 
findBy 字段 名 GreaterThan where 字段 名 > 参数 
findBy 字段 名 LessThan where 字段 名 < 参数 


除 此 之 外 ，JPA 还 支持 isnull、like 和 OrderBy 等 其 他 查询 关键 字 ， 但 在 项 目 里 ,简单 查询 的 
SQL 语句 毕竟 是 少数 ， 在 大 多 数 查询 语句 里 ， 往 往 会 带 3 个 以 上 关键 字 ， 比 如 : 

Select * from student where name=xxx and score>xxx and id in (xxx,xxx) order 
by id asc 

在 类 似 复杂 的 场景 里 ， 就 无 法 直接 使 用 上 述 “ 字 段 名 + 关键 字 ” 形 式 的 方法 了 ， 这 时 就 可 以 通 
过 @Query 引入 较为 复杂 的 SQL 语句 。 注 意 ， 需 要 把 nativeQuery 设 成 tue。 上 有 具体 代码 如 下 : 

1 ， ouery(value = 复杂 的 sql 语句 ，nativeQuery = true) 

List<Student> findStudent (String name,float score,String ids) 7 

6. 在 配置 文件 里 设置 连接 数据 库 的 参数 

在 application.properties 文件 里 ， 我 们 配置 了 MySQL 数据 库 的 各 项 连接 参数 ， 代 码 如 下 : 


1 spring.jpa.show-sql = true 
spring.jpa.hibernate.ddl-auto=update 
spring.datasource.url=jdbc:mysql://localhost:3306/springboot 
spring.datasource.username=root 
spring.datasource.password=123456 
spring.datasource.driver-class-name=com.mysql.jdbc.Driver 


在 第 2 行 里 , 我 们 设置 了 数据 表 的 创建 方式 ,这 里 是 update， 在 启动 本 项 目 时 ，Spring 容器 会 
把 本 地 的 映射 文件 和 数据 表 做 个 比较 ， 如 果 有 差别 ， 就 用 本 地 映射 文件 里 的 定义 更 新 数据 表 结 构 ， 
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如 果 无 差别 ， 就 什么 也 不 做 。 这 里 如 果 没 有 特殊 情况 ， 不 要 用 create， 因 为 create 的 含义 是 “删除 
后 再 创建 ”， 这 样 会 导致 数据 表 的 数据 丢失 。 

在 第 3~6 行 中 ， 我 们 定义 了 连接 url、 用 户 名 、 密 码 和 连接 驱动 等 属性 。 

7. 编写 本 地 映射 文件 

由 于 Spring data JPA 属于 一 种 数据 持久 化 映射 技术 ， 因 此 我 们 需要 在 本 地 开发 一 个 能 和 
Student 数据 表 关联 的 Model 对 象 ， 代 码 如 下 : 


package jpademo .model1;// 为 了 被 扫描 到 ， 同 样 是 处 于 jpademo 的 子 目录 
// 省 略 必 要 的 import 方法 
@Entity 
@Table (name="Student") // 和 Student 数据 表 关联 
public class Student { 

@Iqd // 通 过 eId 定义 主键 

Private String ID; 

@Column (name = "Name") 

Private String name; 

@Column (name = "Age") 

Private String age; 

@Column (name = "Score") 

Private float score; 


// 省 略 必要 的 get 和 set 方法 


oamwmewnP 


vv 
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其 中 ， 我 们 通过 第 3 行 和 第 4 行 的 注解 来 说 明 本 类 是 用 来 映射 Student 表 的 ; 通过 第 6 行 的 
@Id 注 解 ,我 们 指定 了 第 7 行 的 ID 属性 是 用 来 映射 表 里 的 主键 ID 的 ;通过 类 似 于 第 8 行 的 @Column 
注解 ， 后 面 我 们 一 一 指定 了 本 类 里 属性 和 Student 数据 表 里 的 对 应 关系 。 

8. 查看 运行 结果 

至 此 ， 代 码 编写 完成 。 运 行 前 ， 我 们 需要 到 student 表 里 插入 一 条 name 是 tom、score 是 100.0 
的 数据 。 通 过 DataServerAppjava 启动 web 服务 后 ， 在 浏览 器 里 输入 

“http://localhost:8080/students/find/name/tom ”， 就 会 触发 Controller 层 里 的 getStudentByName， 在 
浏览 器 里 能 看 到 如 下 所 示 的 结果 。 

[{"name":"tom","age":"12","score":100.0,"id":"1"}] 

如 果 输 入 “http://localhost:8080/students/nameAndscore/tom/100”, 就 调用 findByNameAndScore 
方法 ， 也 能 看 到 同样 的 结果 。 


2.2.2 ”使 用 yml 格式 的 配置 文件 


在 刚才 的 例子 里 ， 我 们 是 把 配置 文件 写 在 .properties 文件 里 ， 在 项 目 里 ， 我 们 还 可 以 使 用 扩展 
名 是 yml 的 YAML 文件 来 存放 配置 信息 。 

和 传统 的 配置 文件 相 比 ，yml 文件 结构 性 比较 强 ， 比 较 容易 被 理解 ， 在 企业 级 系统 里 也 被 广泛 
应 用 。 

这 里 我 们 将 在 刚才 SpringBootJPAMySQLDemo 项 目的 基础 上 稍 做 修改 ， 在 其 中 将 会 用 到 yml 
文件 来 存放 数据 库 的 连接 信息 。 
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代码 位 置 视频 位 置 
代码 \ 第 2 章 \SpringBootJPAYMLDemo 视频 \ 第 2 章 \YML 配置 文件 演示 
在 这 个 项 目 里 ， 需 要 去 掉 application.properties 文件 ， 在 相同 的 位 置 添加 一 个 application.yml 
文件 ， 代 码 如 下 : 


于 spring: 

六 jpa: 

| show-sql: true 

4 hibernate: 

5 dll-auto: update 
6 datasource: 

1 url: jdbc:mysql://localhost:3306/springboot 
8 username: root 

9 password: 123456 

10 driver-class-name: com.mysql.jdbc.Driver 


t 


在 上 述 文件 里 ， 我 们 能 看 到 yml 是 用 缩 进来 定义 层级 关系 的 。 其 中 ， 第 1~3 行 的 代码 等 价 于 
spring.jpa.show-sql = true， 其 他 的 配置 信息 以 此 类 推 。 而 且 ， 建 议 在 定义 属性 的 冒号 后 面 空 一 格 再 
定义 属性 的 值 。 


2.2.3 ”通过 profile 文件 映射 到 不 同 的 运行 环境 


我 们 在 项 目 里 经 常会 根据 不 同 的 运行 环境 使 用 不 同 的 配置 信息 ， 比 如 在 测试 环境 里 连接 测试 
数据 库 ， 在 生产 环境 里 连接 生产 库 ， 又 如 ,在 测试 和 生产 环境 里 往 不 同 的 位 置 输 出 日 志 信息 。 通 过 
profile， 我 们 能 轻易 地 实现 这 种 效果 。 


代码 位 置 视频 位 置 


代码 \ 第 2 章 \SpringBooUPAProfileDemo 视频 \ 第 2 章 \ 通 过 profile 文件 映射 到 不 同 环境 


这 个 项 目 是 在 2.2.2 小 节 的 SpringBootJPAYMLDemo 项 目 基 础 上 修改 而 成 的 ， 这 里 我 们 将 为 
QA 和 PROD 环境 配置 不 同 的 数据 库 连 接 参数 。 
修改 点 1， 在 application.yml 里 设置 QA 和 PROD 两 个 环境 的 配置 信息 ， 代 码 如 下 : 


spring: 

3 profiles: QA 

3 jpa: 

4 show-sql: true 

5 hibernate: 

6 dll-auto: create 

7 datasource: 

8 url: jdbc:mysql://localhost:3306/springboot 
9 username: root 

10 password: 123456 

be driver-class-name: com.mysql.jdbc.Driver 
i 

13 spring: 

14 profiles: PROD 

TS jpa: 


16 show-sql: false 
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Br hibernate: 

18 dll-auto: update 

19 datasource: 

20 url: jdbc:mysql://localhost:3306/springboot 
rl username: root 

安全 password: 123456 

23 driver-class-name: com.mysql.jdbc.Driver 


其 中 ， 第 1~11 行 配置 的 是 QA 环境 的 信息 ， 第 13~23 行 配置 的 是 PROD， 中 间 用 第 12 行 的 
横 线 分 隔 ， 这 个 分 隔 符 纯粹 是 为 了 提升 可 读 性 ,开发 中 可 以 不 加 这 个 内 容 。 上 述 代码 的 关键 是 在 第 
2 行 和 第 14 行 里 ， 用 spring.profiles = XX 的 形式 来 指定 该 段 代码 的 作用 域 。 

修改 点 2， 在 启动 文件 App.java 里 ， 修 改 代码 如 下 : 


1 // 省 略 必要 的 package 和 import 代码 

2 @SpringBootApplication 

3 public class App 

| 

5 public static void main( String[] args ){ 

6 ConfigurableApplicationContext context = 
new SpringApplicationBuilder (App.class) .Properties( 
"spring.config.location=classpath:/application.yml") 
.Properties ("spring.profiles.active=QA") .run(args); 

加 ; 

.RS 


这 里 通过 第 6 行 的 代码 以 .properties("spring.profiles.active=XX") 的 形式 指定 该 以 QA 或 PROD 
模式 启动 服务 ， 从 而 指定 本 程序 读 取 的 是 测试 还 是 生产 环境 的 数据 库 连 接 参 数 。 


2.3 ”通过 JPA 实现 各 种 关联 关系 


在 实际 项 目 里 ， 我 们 会 关联 查询 多 张 数据 表 ， 从 中 获得 必要 的 业务 数据 ， 对 应 地 ， 我 们 也 可 
以 通过 JPA 把 基于 多 表 的 各 种 关联 关系 映射 到 Model 类 里 。 

具体 而 言 ， 表 之 间 的 关联 关系 可 以 是 一 对 一 、 一 对 多 或 多 对 多 ， 通 过 JPA， 我 们 能 用 比较 简 
单 的 方式 来 实现 这 些 关联 关 系 。 


2.3.1 一 对 一 关联 


代码 位 置 视频 位 置 
代码 \ 第 2 章 \SpringBooUPAOne2OneDemo 视频 第 2 章 \JPA 一 对 一 关联 演示 
在 这 个 业务 场景 里 ， 我 们 让 一 个 学 生 〈Student) 只 能 拥有 一 张 银 行 卡 〈Card) ， 具 体 而 言 ， 
学 生 和 银行 卡 之 间 是 一 对 一 关联 。 
步骤 01& 创建 学 生 和 银行 卡 这 两 张 数据 表 。 学 生 表 的 结构 如 表 2.4 所 示 , 其 中 用 cardID 来 表 
示 该 学 生 所 拥有 的 银行 卡号 。 
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表 2.4 一 对 一 关联 里 的 Student 表 结构 


id varchar 主键 ， 学 号 


成 绩 
对 对 应 的 银行 卡号 


描述 银行 卡 的 Card 表 结 构 如 表 2.5 所 示 。 


表 2.5 一 对 一 关联 里 的 Card 表 结 构 


cardID varchar | 卡号 , 与 Student 表 里 的 cardID 关联 
[mn | 全 县 | 


balance 


步骤 024 在 pom.xml 里 描述 本 项 目的 依赖 包 。 在 这 个 项 目 里 , 我 们 将 和 之 前 的 项 目 一 样 , 依 
赖 JPA、Spring Boot 以 及 MySQL 的 jar 包 ， 所 以 就 不 再 给 出 详细 的 代码 了 。 
步骤 034 在 application.yml 里 配置 jpa 以 及 mysql 数据 库 连 接 的 信息 ， 代 码 如 下 : 


村 
2 
3 
4 
5 
6 
了 
8 
9 


0 


spring: 
jpa: 
show-sql: true 
hibernate: 
dll-auto: update 
datasource: 


url: jdbc:mysql://localhost:3306/springboot 
username: root 

password: 123456 

driver-class-name: com.mysql.jdbc.Driver 


这 里 同样 要 注意 缩 进 ， 而 且 这 里 代码 的 具体 含义 在 之 前 的 项 目 介绍 里 都 解释 过 ， 所 以 就 不 再 


额外 解释 了 。 


步骤 04 编写 用 来 映射 数据 表 的 学 生 和 银行 卡 的 Model 类 ， 其 中 Studentjava 的 代码 如 下 : 


ownamwm 必 wm 


// 省 略 必 要 的 package 和 import 代码 

@Entity 

eTable (name="Student") // 映 射 到 MySQL 里 的 Student 表 
Public class Student { 


@Id // 主 键 

Private String ID; 

@Column (name = "Name") // 通 过 ecolumn 指定 映射 的 列 名 
Private String name; 

@Column (name = "Age") 

Private String age; 

@Column (name = "Score") 

Private float score; 

// 通 过 @OneToOne 来 指定 和 Card 的 一 对 一 关联 关系 
QoneToone (cascade = CascadeType.ALL) 
@JoinColumn (name = "cardID", unique=true) 
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private Card card; 
// 省 略 必要 的 get 和 set 方法 
} 


在 上 述 代 码 的 第 14~16 行 中 ， 通 过 @OneToOne 的 注解 指定 了 Student 和 Card 的 一 对 一 关联 ， 
其 中 通过 第 15 行 的 @JoinColumn 来 表示 是 通过 cardID 来 关联 到 Card 表 的 。 

Cardjava 代码 如 下 ， 这 个 类 比较 简单 ， 通 过 第 2 行 和 第 3 行 的 @Entity 和 Table 注解 来 指定 待 
关联 的 数据 表 名 ， 通 过 第 5 行 的 @Id 来 指定 主键 ， 通 过 第 7 行 的 @Column 来 指定 对 应 的 列 名 。 


上 


Pioowaowmww 
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// 省 略 必 要 的 package 和 import 代码 
QEntity 
eTable (name="Card") // 指 定 关联 到 card 表 
public class Card { 
@Id 
private String cardID;// 指 定 主键 
ecolumn (name = "balance") // 指 定 映射 的 列 名 


Private float balance; 
// 省 略 必要 的 get 和 set 方法 
} 


步骤 054 编写 控制 器 类 StudentControllerjava， 具 体 代码 如 下 : 


PpooJJAnAwDNDp 


0 
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// 省 略 必 要 的 package 和 import 代码 
QRestController // 指 定 本 类 是 控制 器 类 
@RequestMapping (value = "/students") 
public class StudentController { 
@Autowired 
Private StudentService studentService; 
@RequestMapping (value = "/one2oneDemo") 
Public void one2oneDemo () { 
studentService.one2oneDemo () ; 
1 


在 上 述 代 码 的 第 7 行 和 第 8 行 里 ,我 们 能 看 到 ,/one2oneDemo 格式 的 请 求 将 触发 one2oneDemo 
方法 ， 在 这 个 方法 里 ， 将 调用 service 层 的 对 应 方法 。 
步骤 064 编写 实现 Service 层 功能 的 StudentService.java， 代 码 如 下 : 


oamwmwewnP 


// 省 略 必要 的 package 和 import 代码 
@Service 
public class StudentService { 
@Autowired 
private StudentRepository stuRepository; 
Public void one2oneDemo () { 
// 创 建 一 个 学 生 
Student s = new Student () 7 
SSGLID(E) 
s.setName ("Peter"); 
s.setScore(100); 
s.setAge ("12"); 
// 创 建 一 张 卡 
Card card = new Card(); 
card.setCardID ("card1"); 
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} 


card.setBalance (200); 
s.setCard(card); 
// 保 存 学 生 信息 
stuRepository.save(s); 
// 通 过 学 生 找 到 卡 ， 并 打印 卡 信息 
Student peter = stuRepository.findByName ("Peter") .get (0); 
System.out .println (peter.getCard() .getCardID()); 
System.out .println (peter.getCard() .getBalance ()); 

// 删 除 学 生 后 ， 卡 信息 也 会 一 并 被 删除 

stuRepository.delete(s); 


在 上 述 代 码 里 ， 我 们 能 看 到 学 生 和 银行 卡 之 间 的 关联 关系 。 具 体 而 言 ， 当 我 们 在 第 19 行 save 
学 生 信息 后 ， 能 在 第 21 行 通过 name 找到 该 学 生 所 对 应 的 卡 ， 在 第 22 行 和 第 23 行 里 ， 能 打印 出 


对 应 的 卡 信息 。 
于 之 前 设置 的 学 生 和 银行 卡 之 间 的 级 联 关系 〈CascadeType) 是 ALL， 其 中 也 包含 “删除 ”， 


由 


因此 在 第 25 行 里 ， 当 我 们 通过 delete 语句 删除 学 生 信息 后 ， 就 能 发 现 card 表 里 和 该 学 生 对 应 的 银 
行 卡 记录 也 会 被 删除 。 


步 又 07 4 实现 StudentRepository 接口 ， 在 其 中 实现 针对 数据 库 的 操作 ， 具 体 代码 如 下 : 


// 省 略 必 要 的 package 和 import 代码 

@Component 

Public interface StudentRepository extends JpaRepository<Student, Long>{ 
@Query (value = "from Student s where s.name=:name") 
List<Student> findByName (@Param("name") String name); 


二 
2 
3 
4 
5 
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} 


我 们 在 第 4 行 和 第 5 行 的 代码 里 ， 实 现 了 根据 name 查找 Student 对 象 的 功能 ， 至 于 在 Service 
层 里 调用 的 save 和 delete 方法 ， 则 是 封装 在 JpaRepository 类 里 的 ， 我 们 无 须 编写 。 
最 后 ， 我 们 还 得 在 Appjava 里 实现 SpringBoot 的 启动 代码 ， 这 块 我 们 之 前 已 经 提 到 过 ， 所 以 


就 不 再 解释 了 。 


@SpringBootApplication 
Public class APP{ 
Public static void main( String[] args ) 


aowm 必 wm 


} 


SpringApplication.run (App.class, args); 


至 此 ， 当 我 们 通过 App.java 启动 Spring Boot 时 ， 就 能 通过 在 浏览 器 里 输入 如 下 url 来 查看 效 


果 了 。 


http://localhost:8080/students/one2oneDemo 


根据 Controller 层 的 定义 ， 该 url 请 求 会 触发 Service 层 里 的 one2oneDemo 方法 ， 大 家 如 果 查 
看 数据 库 ， 就 能 看 到 “插入 学 生 后 对 应 的 银行 卡 信 息 也 能 自动 插入 ”以 及 “删除 学 生 后 对 应 的 卡 也 
会 自动 删除 ”的 级 联 操作 效果 。 
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2.3.2 一 对 多 关联 


代码 位 置 视频 位 置 
代码 \ 第 2 章 \SpringBootJPAOne2ManyDemo 视频 \ 第 2 章 \JPA 一 对 多 关联 
这 里 ， 我 们 将 实现 一 个 用 户 (User) 拥有 多 辆 汽车 (Car) 的 业务 场景 。 其 中 ， 用 户 表 的 结构 
如 表 2.6 所 示 ， 描 述 汽车 的 Car 表 结 构 如 表 2.7 所 示 。 


表 2.6 一 对 多 关联 里 的 User 表 结 构 


字段 名 类 型 合 义 
userID Int 用 户 ID， 主 键 ， 自 增长 
| Name varchar | 用 户 姓名 


表 2.7 一 对 多 关联 里 的 Car 表 结 构 


| 用 户 ID， 外 键 ， 与 User 表 关 联 
在 创建 完 Maven 类 型 的 SpringBootJPAOne2ManyDemo 项 目 后 ， 在 其 中 的 pom.xml 里 ， 我 们 
将 和 之 前 的 项 目 一 样 ， 同 样 引入 JPA、Spring Boot 以 及 MySQL 的 jar 包 。 
由 于 这 里 连接 的 数据 库 和 之 前 “2.3.1” 小节 中 的 一 致 ， 因 此 application.yml 用 的 是 和 之 前 一 样 
的 代码 。 
在 Userjava 和 Carjava 这 两 个 Model 类 里 ， 我 们 将 定义 一 对 多 关联 关系 ， 其 中 Userjava 的 代 
码 如 下 : 
1 “// 省 略 必要 的 Package 和 import 代码 
@Entity 
eTable (name="User") // 指 定 关 联 到 User 表 


2 

3 

4 public class User { 
5 @Id 
6 

7 

8 


@Column (name="userID") // 定 义 主键 
@GeneratedValue (strategy = GenerationType.IDENTITY) 
Private int userID; 


3 @Column (name = "name") 

10 Private String name; 

11 // 通 过 aoneToMany 定义 一 对 多 关联 

Bey @OneToMany (cascade = CascadeType.ALL,mappedBy = "user") 
3 Private Set<Car> cars; 

14 // 省 略 必要 的 get 和 set 方法 

eh 


在 第 13 行 里 ， 我 们 通过 Set 类 来 存放 一 个 用 户 拥有 的 多 辆 汽车 。 在 第 12 行 里 ， 我 们 通过 
@OneToMany 注解 定义 了 “一 个 用 户 拥有 多 辆 车 ”的 关系 。 这 里 cascade 的 级 联 关系 是 ALL， 也 
就 是 说 ， 一 旦 从 数据 表 里 删 除 这 个 用 户 ， 那 么 对 应 的 汽车 也 会 从 数据 表 里 被 删除 ，mappedBy 的 取 
值 是 user， 也 就 是 说 ， 在 Car 类 里 使 用 过 这 个 属性 来 指定 车 的 主人 。 

描述 汽车 类 的 Carjava 的 代码 如 下 : 
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// 省 略 必要 的 package 和 import 代码 
@Entity 

eTable (name="Car") // 和 Car 表 相 关联 
public class Car { 


@Id 

QColumn (name="carID") /主键 

@GeneratedValue (strategy = GenerationType.IDENTITY) 
Private int carID; 

@Column (name = "price") 

Private float price; 

@ManyToOne (cascade = CascadeType.ALL) 

@JoinColumn (name="userID") 

Private User user; 


// 省 略 必要 的 get 和 set 方法 


在 这 里 的 第 11~13 行 里 ， 通 过 @ManyToOne 的 注解 来 定义 汽车 和 用 户 的 关联 关系 ， 其 中 用 第 
12 行 的 @JoinColumn 来 指定 Car 类 是 通过 userID 这 个 属性 和 User 类 关联 的 ， 第 13 行 定 义 的 user 
类 则 指定 了 这 个 Car 的 主人 。 
在 userController.java 里 ， 我 们 定义 了 这 个 Spring Boot 项 目的 “控制 器 类 ”， 有 具体 代码 如 下 : 


上 


PPieoowawmwwn 
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// 省 略 必 要 的 package 和 import 代码 
Q@RestController // 指 定 该 类 是 控制 器 类 
@RequestMapping (value = "/users") 
public class userController { 


@Autowired 
Private UserService userService; 
@RequestMapping (value = "/one2manyDemo") 


public void one2manyDemo() { 
userService.one2manyDemo (); 


’ 


在 第 7 行 里 ， 我 们 通过 @RequestMapping 注解 定义 了 触发 该 方法 的 url 格式 ， 在 第 8 行 的 
one2manyDemo 方法 里 ， 调 用 了 service 层 里 的 one2manyDemo 方法 。 下 面 我 们 来 看 一 下 
UserServicejava 这 段 代码 。 


oaumwwN 


// 省 略 必 要 的 package 和 import 代码 
eservice // 指 定 本 类 是 service 


Public class UserService { 


@Autowired 
Private UserRepository userRepository; 
Public void one2manyDemo (){ 
// 创 建 两 个 car 对象 
Car carl = new Car() 7 
carl.setPrice(100); 
Car car2 = new Car(); 
Car2.setPrice(200); 
// 创 建 一 个 用 户 
User user = new User(); 
user.setName ("Peter"); 
// 设 置 两 辆 车 的 主人 是 Peter 


carl.setUser (user); 
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TT car2.setUser (user); 

18 // 定 义 一 个 set， 放 入 两 辆 车 

19 Set<Car> cars = new HashSet<Car>(); 
20 cars.add (carl); 

2 cars.add (car2); 

22 // 给 用 户 指定 两 辆 车 

23 user.setCars (cars); 

24 // 通 过 save 方法 存 入 用 户 

25 userRepository.save (user); 

26 // 先 注释 掉 这 行 代码 

2 了 //userRepository.delete (user); 
28 } 

29 1} 


在 上 述 代 码 的 第 8~23 行 里 ， 我 们 定义 了 一 个 用 户 和 两 辆 车 ， 并 设置 了 “Peter” 拥 有 两 辆 车 的 
一 对 多 关系 。 当 我 们 在 第 25 行 通过 save 方法 存 入 用 户 时 ， 不 仅 能 在 User 表 里 看 到 对 应 的 用 户 信 
息 ， 还 能 在 Car 表 里 看 到 关联 的 两 辆 车 也 被 插入 了 。 

如 果 我 们 打开 第 27 行 的 注释 ， 就 会 发 现 虽然 我 们 只 是 通过 delete 方法 删除 了 用 户 ， 但 由 于 这 
里 一 对 多 的 级 联 关系 是 ALL， 因 此 这 个 用 户 所 对 应 的 两 辆 车 也 会 被 从 Car 数据 表 里 删 除 。 

在 上 述 UserService.java 里 , 我 们 事实 上 是 调用 了 UserRepository 这 个 和 JPA 有 关 类 里 的 方法 ， 
在 这 个 Repository 接口 里 ， 我 们 只 是 继承 了 JpaRepository， 在 其 中 什么 都 没 做 ， 具 体 代 码 如 下 : 

1 component 

2 public interface UserRepository extends JpaRepository<User, Long> 

| 

也 就 是 说 ， 在 Service 层 里 ， 我 们 使 用 了 JpaRepository 里 自 带 的 save 和 delete 方法 。 

最 后 ， 我 们 还 得 编写 该 Spring Boot 的 启动 类 App.java， 代 码 如 下 : 
1 “// 省 略 必要 的 pacage 和 import 代码 
2  @SpringBootApplication 
3 public class App{ 
4 public static void main( String[] args ) 
SpringApplication.run (APP.class，args) 
人 

当 我 们 启动 上 述 App.java， 并 在 浏览 器 里 输入 “http:Wlocalhost:8080/users/one2manyDemo ”后 ， 
就 会 触发 UserService 类 里 的 one2manyDemo 方法 ， 从 而 看 到 本 案例 的 演示 效果 。 


2.3.3 多 对 多 关联 


代码 位 置 视频 位 置 
代码 \ 第 2 章 \SpringBootJPAMany2ManyDemo 视频 \ 第 2 章 \JPA 多 对 多 关联 


这 里 ， 我 们 将 实现 多 本 图 书 (Book) 和 多 名 作者 〈Author) 之 间 的 多 对 多 关系 ， 有 具体 而 言 ， 
一 本 书 可 以 有 多 名 作者 ， 同 一 作者 可 以 写 多 本 书 。 
在 表 2.8 中 ， 我 们 定义 了 描述 图 书 的 Book 表 。 


| 和 
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表 2.8 多 对 多 关联 里 的 Book 表 结 构 


字段 名 类 型 含义 
bookID int ID， 主 键 
| Name varchar | 图 书 的 名 字 | 


描述 作者 的 Author 表 结 构 如 表 2.9 所 示 。 
表 2.9 多 对 多 关联 里 的 Author 表 结构 


字段 名 类 型 含义 
authorID int ID， 主 键 
name varchar | 作者 的 姓名 


同时 ， 我 们 还 需要 创建 book_author 表 来 描述 书 和 作者 的 多 对 多 关联 ， 结 构 如 表 2.10 所 示 。 
表 2.10 多 对 多 关联 里 的 book_author 表 结构 


| aop |m |f#pD 
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在 创建 完 Maven 类 型 的 SpringBootJPAMany2ManyDemo 项 目 后 , 在 其 中 的 pom.xml 里 , 我 们 
将 和 之 前 的 项 目 一 样 ， 同 样 引 入 JPA、Spring Boot 以 及 MySQL 的 jar 包 。 

在 Bookjava 和 Authorjava 这 两 个 Model 类 里 , 我 们 将 定义 多 对 多 关联 关系 。 其中, Book.java 
的 代码 如 下 : 


1 “// 省 略 必要 的 package 和 import 代码 

电 @Entity 

3 ”QTable (name="Book") // 和 Book 表 相 关联 

4 public class Book { 

5 @Id // 主 键 

6 Private int bookID; 

gh @Column (name = "name") 

8 Private String name; 

9 // 定 义 多 对 多 关联 

10 @ManyToMany (cascade = CascadeType.ALL) 

kb @JoinTable (name = "book author", joinColumns = { 

rb) @JoinColumn (name = "bookID", referencedColumnName = "bookID")}, 
inverseJoinColumns = { 

了 @JoinColumn (name = "authorID", referencedColumnName = "authorID") }) 

14 Private Set<Author> authors; 

5 // 省 略 对 应 的 get 和 set 方法 

i | 


在 第 10 行 中 ， 我 们 定义 了 图 书 和 作者 的 多 对 多 关联 ; 在 第 11~13 行 中 ， 定 义 了 book_author 
表 里 分 别 用 bookID 和 authorID 来 描述 双方 的 多 对 多 关系 ; 在 第 14 行 中 , 通过 Set 来 描述 这 本 图 书 
里 的 多 名 作者 信息 。 

描述 作者 类 的 Authorjava 的 代码 如 下 , 其 中 通过 第 10 行 的 @ManyToMany 注解 来 定义 作者 和 
图 书 的 多 对 多 关联 ， 通 过 第 11 行 定义 Set 类 型 的 books 属性 来 存放 作者 所 写 的 多 本 书 。 


32 | 
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// 省 略 必要 的 package 和 import 代码 

@Entity 

eTable (name="Author") // 指 定 该 类 和 Author 表 相 关联 
public class Author { 


} 


eId // 主 键 

Private int authorID; 

@Column (name = "name") 

Private String name; 

// 指 定 Author 和 Book 的 多 对 多 关联 
@ManyToMany (mappedBy = "authors") 
Private Set<Book> books; 


// 省 略 必 要 的 get 和 set 方法 


在 Controllerjava 里 ， 我 们 定义 “控制 器 类 ”， 具 体 代 码 如 下 : 


// 省 略 必要 的 package 和 import 代码 
QRestController // 定 义 控制 器 类 
@RequestMapping (value = "/books") 
Public class Controller { 


» 
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} 


@Autowired 

Private BookService bookService; 

@RequestMapping (value = "/many2manyDemo") 

public void many2manyDemo() { 
bookService.many2manyDemo (); 


} 


其 中 ,在 第 7 行 中 ， 我 们 通过 @RequestMapping 注解 定义 了 触发 该 方法 的 url 格式 ; 在 第 8 行 
的 many2manyDemo 方法 中 ， 调 用 了 service 层 里 的 对 应 方法 。 下 面 我 们 来 看 一 下 bookService.java 


代码 。 


oamumwwn 


// 省 略 必要 的 package 和 import 代码 
@Service 
Public class BookService { 


@Autowired 
Private BookRepository bookRepository; 
@Autowired 
private AuthorRepository authorRepository; 
Public void many2manyDemo() 
{ 
// 定 义 三 位 作者 
Author authorl = new Ruthor () 7 
author1l .setRAuthorID(1) 7 
authorl.setName ("Peter"); 
Author author2 = new Ruthor () 7 
author2 .setRAuthorID(2) 7 
author2 .setName ("Tom"); 
Author author3 = new Author () 7 
author3 .setRuthorID (3) 7 
author3 .setName ("Ben"); 
// 创 建 两 本 书 
Book javaBook = new Book(); 
javaBook.setBookID(1); 
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23 javaBook.setName ("Java"); 

24 Book dbBook = new Book(); 

25 GbBook.setBookID(2); 

26 dbBook.setName ("Oracle"); 

2 // 通 过 两 个 set 存放 Java 书 和 DB 书 的 作者 

28 Set<Author> javaAuthors = new HashSet<Author>(); 
29 javaAuthors.add (author1); 

30 javaAuthors.add (author3); 

3 Set<Author> dbAuthors = new HashSet<Author>(); 
32 dbAuthors.add (author2); 

33 dbAuthors.add (author3); 

34 // 设 置 Java 书 和 DB 书 的 作者 

35 javaBook.setAuthors (javaAuthors); 

36 dbBook.setAuthors (dbAuthors); 

37 // 保 存 java 书 和 DB 书 

38 bookRepository.save (javaBook); 

39 bookRepository.save (dbBook); 

40 } 

41 1} 


在 上 述 代码 的 第 10~36 行 里 ， 我 们 完成 了 如 下 动作 。 


第 一 ， 定 义 了 3 名 作者 信息 。 

第 二 ， 创 建 了 java 和 DB 两 本 书 的 信息 。 

第 三 ， 定 义 了 两 个 Set， 在 其 中 存放 了 两 本 书 的 作者 信息 。 

第 四 ， 给 两 本 书 设置 了 对 应 Set， 以 此 指定 两 本 书 的 作者 。 

在 第 38~39 行 中 ， 我 们 通过 save 方法 保存 了 两 本 书 ， 此 时 我 们 能 看 到 如 下 效果 。 
第 一 ， 在 Book 表 里 能 看 到 Java 和 DB 图 书 的 信息 。 


第 二 ， 在 Author 表 里 ， 能 看 到 3 名 作者 的 信息 。 
第 三 ， 在 book_author 表 里 ， 能 看 到 图 书 和 作者 的 对 应 关系 。 


在 上 述 的 Service 类 里 ,我 们 事实 上 是 调用 了 BookRepository 和 AuthorRepository 这 两 个 和 JPA 
有 关 的 类 中 的 方法 。 同 样 地 ， 在 这 两 个 类 里 我 们 只 是 继承 了 JpaRepository 这 个 接口 ， 在 其 中 什么 
都 没 做 。BookRepository 类 的 具体 代码 如 下 : 


1 @Component 
2 public interface BookRepository extends JpaRepository<Book, Long> 
:SEE | 


AuthorRepository 类 的 代码 如 下 : 


于 @Component 
2 public interface AuthorRepository extends JpaRepository<Author, Long> 
i 


也 就 是 说 ， 在 Service 层 里 ， 我 们 也 是 使 用 了 JpaRepository 里 自 带 的 save 方法 。 
最 后 ， 我 们 还 得 编写 该 Spring Boot 的 启动 类 App.java， 代 码 如 下 : 


1 // 省 略 必要 的 pacage 和 import 代码 
4 @SpringBootApplication 
3 public class App{ 
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4 public static void main( String[] args ) 
5 

6 SpringApplication.run (App.class, args); 
} 

8 1} 


当 我 们 启动 上 述 Appjava， 并 在 浏览 器 里 输入 “http://localhost:8080/books/many2manyDemo” 
后 ， 就 会 触发 BookService 类 里 的 many2manyDemo 方法 ， 从 而 看 到 本 案例 的 演示 效果 。 


2.4 本 章 小 结 


通过 本 章 的 学 习 ， 大 家 能 发 现 通过 JPA 能 比较 方便 地 开发 基于 MySQL 的 数据 库 业 务 代码 ， 
事实 上 ， 只 要 我 们 在 .yml 文件 里 修改 对 应 的 连接 驱动 、 连 接 URL、 数 据 库 用 户 名 和 密码 ， 就 能 用 
非常 相似 的 代码 来 访问 Oracle 或 SQL Server 等 其 他 数据 库 。 

在 本 章 中 ， 还 讲述 了 通过 JPA 实现 一 对 一 、 一 对 多 和 多 对 多 等 关联 场景 的 方式 。 在 真实 的 项 
目 里 ， 可 能 业务 场景 要 比 这 复杂 ， 但 开发 步骤 是 一 致 的 。 换 句 话 说， 在 学 完 本 章 后 ， 大 家 能 用 同样 
的 方法 很 快 地 实现 各 类 真实 的 “关联 ”业务 。 


服务 治理 框架 : Eureka 


在 微服 务 项 目 里 ， 我 们 需要 关注 能 带 来 实际 价值 的 业务 功能 ， 但 同时 还 得 考虑 “微服 务 如 何 
发 布 ”以 及 “如 何 让 客户 发 现 并 调用 微服 务 ” 这 类 面向 基础 设施 的 问题 。 

我 们 固然 可 以 自己 开发 一 套 “管理 微 服务 ”的 框架 ， 但 这 样 势必 会 增加 项 目的 开发 周期 和 成 
本 ， 事 实 上 Eureka 框架 已 经 提供 了 上 述 功能 。 有 具体 而 言 ， 在 服务 器 端 ， 我 们 能 通过 Eureka 服务 治 
理 框架 发 布 和 注册 服务 ;在 客户 端 ， 我 们 可 以 用 此 发 现 并 调用 微服 务 。 

不 仅 如 此 ， 在 高 并 发 的 场景 里 ， 我 们 还 可 以 配置 Eureka 集群 ， 即 在 多 台 机 器 上 配置 Eureka， 
以 此 来 适应 常见 的 “负载 均衡 ”和 “故障 转移 ”需求 。 


3.1 了 解 Eureka 框架 


Eureka 是 Spring Cloud Netflix 全 家 桶 中 的 一 个 组 件 ， 在 有 些 资料 里 ， 它 也 被 称 为 “服务 发 现 
框架 ”。 不 管 叫 什么 名 字 ， 我 们 都 可 以 通过 它 来 注册 、 发 布 、 发 现 和 调用 服务 。 


3.1.1 Eureka 能 干什么 


在 项 目 里 ， 一 般 存 在 “服务 提供 者 ”和 “服务 调用 者 ”两 种 角色 ， 为 了 调 到 服务 ， 服 务 提供 
者 需要 服务 调用 者 知道 “服务 所 在 的 IP 地 址 、 端 口号 和 提供 服务 的 方法 名 ”这 些 关键 信息 ， 如 果 
服务 比较 多 ， 那 么 该 如 何 维护 这 些 服务 信息 呢 ? 

比较 直观 的 解决 方案 是 “用 静态 的 方式 来 管理 服务 列表 ”， 比 如 在 一 个 配置 文件 里 放 入 所 有 
的 服务 清单 ， 包 括 刚 才 提 到 的 人 P 地 址 、 端 口号 和 方法 名 ， 但 这 未 必 是 一 种 好 的 选项 。 

一 方面 ， 如 果 系统 里 服务 提供 模块 的 数量 很 多 ， 那 么 这 类 配置 文件 就 会 很 长 ， 这 样 可 读 性 就 
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会 很 差 ， 从 而 导致 该 文件 很 难 维护 。 另 一 方面 ， 随 着 项 目的 不 断 深入 ， 服 务 提供 模块 一 定 是 会 不 断 
变更 的 , 在 配置 文件 中 的 服务 列表 信息 也 需要 随 之 不 断 更 改 。 这 不 仅 增 加 了 系统 的 维护 难度 ， 还 会 
提升 诸如 命名 冲突 这 类 问题 的 风险 。 

Eureka 组 件 为 此 提供 了 一 套 较 好 的 解决 方案 。 

第 一 ， 服 务 提供 者 可 以 向 Eureka 注册 中 心 注册 本 模块 可 以 提供 的 服务 。 

第 二 ， 服 务 调用 者 能 从 Eureka 注册 中 心 查找 (也 就 是 发 现 ) 和 调用 所 需 的 服务 。 

第 三 ， 大 家 可 以 把 Eureka 理解 成 第 三 方 的 服务 管理 平台 。 一 旦 有 新 的 服务 生成 或 有 旧 的 服务 
失效 ，Eureka 能 做 到 自动 更 新 服务 列表 ， 这 就 降低 了 因 服 务 不 断 变 更 而 导致 的 项 目 维护 成 本 。 


3.1.2 ”Eureka 的 框架 图 


从 图 3.1 中 ， 我 们 能 看 到 Eureka 的 基本 架构 。 


查找 服务 
Eureka 服 务 器 Eureka 客 户 端 
《包含 注册 中 心 ) 《服务 调用 者 》 
注册 服务 
调用 服务 
Eureka 客 户 端 
《服务 提供 者 》 


3.1 ”Eureka 的 基本 框架 


在 Eureka 的 服务 器 里 ， 包 含 着 记录 当前 所 有 服务 列表 的 注册 中 心 ， 而 服务 提供 者 和 调用 者 所 
在 的 机 器 均 被 称 为 “Eureka 客户 端 ”。 

服务 提供 者 会 和 服务 器 进行 如 下 交互 : 第 一 ， 注 册 本 身 能 提供 的 服务 ， 第 二 ， 定 时 发 送 心 跳 ， 
以 此 证 明 本 服务 处 于 生效 状态 。 服务 调用 者 一 般 会 从 服务 器 查找 服务 , 并 根据 找到 的 结果 从 服务 提 
供 者 端 调用 服务 。 


3.2 构建 基本 的 Eureka 应 用 


在 这 一 部 分 ， 我 们 将 编写 Eureka 的 服务 器 、 服 务 提供 者 和 调用 者 的 代码 ， 并 通过 它们 之 间 的 
交互 来 向 大 家 演示 Eureka 的 开发 步骤 和 工作 流程 。 


3.2.1 搭建 Eureka 服务 器 


这 里 我 们 将 在 EurekaBasicDemo-Server 项 目 里 编写 Eureka 服务 器 的 代码 。 


代码 位 置 视频 位 置 
代码 \ 第 3 章 \EurekaBasicDemo-Server 视频 \ 第 3 章 \ 搭 建 Eureka 服务 器 
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第 一 步 ， 当 我 们 创建 完 Maven 类 型 的 项 目 后 , 需要 在 pom.xml 里 编写 该 项 目 所 需要 的 依赖 包 ， 


关键 代码 如 下 : 
下 <dependencyManagement> 
4 <dependencies> 
| <dependency> 
4 <groupId>org.springframework.cloud</groupId> 
5 <artifactId>spring-cloud-dependencies</artifactId> 
6 <version>Brixton.SR5</version> 
可 <type>pom</type> 
8 <scope>import</scope> 
9 </dependency> 
10 </dependencies> 
TL </dependencyManagement> 
1 be <dependencies> 
3 <dependency> 
14 <groupId>org.springframework.cloud</groupId> 
rh <artifactId>spring-cloud-starter-eureka-server</artifactId> 
16 </dependency> 
17 </project> 


在 第 1~11 行 的 代码 中 ， 我 们 引入 了 版 本 号 是 Brixton.SR5 的 Spring Cloud 包 ， 这 个 包 里 包含 
着 Eureka 的 支持 包 ， 在 第 13~16 行 的 代码 中 ， 引 入 了 Eureka Server 端的 支持 包 ， 引 入 后 ， 我 们 才 
能 在 项 目的 java 文件 里 使 用 Eureka 组 件 的 特性 。 


第 二 步 ， 在 application.yml 里 ， 需 要 配置 Eureka 服务 端的 信息 ， 代 码 如 下 : 


PowauwmwwNP 


0 


Server: 
port: 8888 
eureka: 
instance: 
hostname: localhost 
client: 
register-with-eureka: false 
fetch-registry: false 
serviceUrl: 
defaultZone: http://localhost:8888/eureka/ 


在 第 2 行 和 第 5 行 的 代码 中 ， 我 们 指定 了 Eureka 服务 端 使 用 的 主机 地 址 和 端口 号 ， 这 里 分 别 
是 localhost 和 8888， 也 就 是 说 让 服务 端 运行 在 本 地 的 8888 号 端口 。 在 第 10 行 中 ， 我 们 指定 了 服 
务 端 所 在 的 url 地 址 。 


由 了 


F 这 已 经 是 服务 器 端 ， 因 此 我 们 通过 第 7 行 的 代码 指定 无 须 向 Eureka 注册 中 心 注册 自己 ， 


同 理 , 服务 器 端的 职责 是 维护 服务 列表 而 不 是 调用 服务 , 所 以 通过 第 8 行 的 代码 指定 本 端 无 须 检索 


服务 。 


第 三 


amwewm 


步 ， 在 RegisterCenterApp.java 里 编写 Eureka 启动 代码 。 


/ /省略 必要 的 package 和 import 代码 
Q@EnableEurekaServer // 指 定 本 项 目 是 Eureka 服务 端 
@SpringBootApplication 
public class RegisterCenterApp 
{ 
Public static void main( String[] args ) 
站 
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8 SpringApplication.run (RegisterCenterApp.class, args); 


在 第 6 行 的 main 函数 里 ， 我 们 还 是 通过 run 方法 启动 Eureka 服务 。 

运行 Appjava 启动 Eureka 服务 器 端 后 ， 在 浏览 器 里 输入 “localhost:8888” 后 ， 可 以 看 到 如 图 
3.2 所 示 的 Eureka 服务 器 端的 信息 面板 , 其 中 Instances currently registered with Eureka 目前 是 空 的 ， 
说 明 尚未 有 服务 注册 到 本 服务 器 的 注册 中 心 。 
DS Replicas 
Instances currently registered with Eureka 


Application AMis Availability Zones Status 


No instances available 


图 3.2 ”Eureka 服务 器 端的 信息 面板 示意 图 


3.2.2 ”编写 作为 服务 提供 者 的 Eureka 客户 端 


这 里 我 们 将 在 EurekaBasicDemo-ServerProvider 项 目 里 编写 Eureka 客户 端的 代码 。 在 这 个 项 目 
里 ， 我 们 将 提供 一 个 SayHello 的 服务 。 


代码 位 置 视频 位 置 


代码 \ 第 3 章 \EurekaBasicDemo-ServerProvider 视频 \ 第 3 章 \ 搭 建 提供 服务 的 Eureka 客户 端 


第 一 步 ， 创 建 完 Maven 类 型 的 项 目 后 ， 我 们 需要 在 pom.xml 里 写 入 本 项 目的 依赖 包 ， 关 键 代 
码 如 下 。 本 项 目 所 用 到 的 依赖 包 之 前 都 用 过 ， 所 以 这 里 就 不 展开 讲 了 。 


<dependencyManagement> 

2 <dependencies> 

3 <dependency> 

4 <groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-dependencies</artifactId> 


3 <version>Brixton.SR5</version> 
6 <type>pom</type> 

了 <scope>import</scope> 

8 </dependency> 

和 </dependencies> 


10 </dependencyManagement> 
4 <dependencies> 


2 <dependency> 

13 <groupId>org.springframework.boot</groupId> 

14 <artifactId>spring-boot-starter-web</artifactId> 
15 <version>1.5.4.RELEASE</version> 

16 </dependency> 

dN <dependency> 

18 <groupId>org.springframework.cloud</groupId> 

下 9 <artifactIid>spring-cloud-starter-eureka</artifactId> 


20 </dependency> 
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2 </dependencies> 


第 二 步 ， 在 application.yml 里 编写 针对 服务 提供 者 的 配置 信息 ， 代 码 如 下 : 


server: 
Port: 1111 
spring: 
application: 
name: sayHello 
eureka: 
client: 
serviceUrl: 
defaultZone: http://localhost:8888/eureka/ 


从 第 2 行 里 , 我 们 能 看 到 本 服务 将 启用 1111 号 端口 ; 在 第 5 行 中 , 我 们 指定 了 本 服务 的 名 字 ， 
叫 sayHello; 在 第 9 行 中 ， 我 们 把 本 服务 注册 到 了 Eureka 服务 端 ， 也 就 是 注册 中 心里 。 
第 三 步 ， 在 Controllerjava 里 编写 控制 器 部 分 的 代码 ， 在 其 中 实现 对 外 的 服务 。 


ownamwmewnP 


1 “// 省 略 必要 的 package 和 import 代码 
2 ”QRestController // 说 明 这 是 一 个 控制 器 
法 Public class Controller { 
4 @Autowired // 描 述 Eureka 客户 端 信息 的 类 
5 Private DiscoveryClient eurekaClient; 
6 @RequestMapping (value = "/hello/{username}", 
method = RequestMethod.GET ) 
加 public String hello (GPathVariable("username") String Username) { 
8 ServiceInstance inst = eurekaClient.getLocalServiceInstance(); 
9 // 输 出 服务 相关 的 信息 
10 System.out .Println("host is:" + inst.getHost()) 7 
i System.out.println("port is:" + inst.getPort()); 
12 System.out .Println("ServiceID is:" + inst.getServiceId() ); 
1 System.out .Println("url path is:" + inst.getUri() .getPath())， 
14 // 返 回 字符 串 
15 return "hello " + username; 
16 } 
br a 


我 们 通过 第 6 行 和 第 7 行 的 代码 指定 了 能 触发 hello 方法 的 url 格式 ， 在 这 个 方法 里 ， 我 们 首 
先 通过 第 10~13 行 的 代码 输出 了 主机 名 、 端 口号 和 ServiceID 等 信息 ， 并 在 第 15 行 里 返回 了 一 个 
字符 串 。 
第 四 步 ， 编 写 Spring Boot 的 启动 类 ServiceProviderApp.java， 代 码 如 下 : 


1 “// 省 略 必 要 的 package 和 import 代码 

2  Q@SspringBootApplication 

3  Q@EnableEurekaClient 

4 public class ServiceProviderApp { 

5 public static void main( String[] args ) 

6 ' 

7 SpringApplication.run(ServiceProviderApp.class, args); 

8 } 

ge 

由 于 这 是 处 于 Eureka 的 客户 端 ， 因此 加 入 第 3 行 所 示 的 注解 , 在 main 函数 里 ,我 们 依然 是 通 
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过 run 方法 启动 Spring Boot 服务 。 
3.2.3 ”编写 服务 调用 者 的 代码 


启动 Eureka 服务 器 端的 RegisterApp.java 和 服务 提供 者 端的 ServiceProviderAppjava， 在 浏览 
器 里 输入 “http://localhost:8888/” 后 , 在 Eureka 的 信息 面板 里 能 看 到 SayHello 服务 , 如 图 3.3 所 示 。 


Instances currently registered with Eureka 


Application Availability Zones 


SAYHELLO n/all) (1) UP (1) - 192.168.42.1-:sayHello:1111 


图 3.3 在 Eureka 信息 面板 里 能 看 到 SayHello 服务 


这 时 在 浏览 器 里 输入 “http://localhost:1111/hello/Mike ”， 就 能 直接 调用 服务 ， 同 时 能 在 浏览 
器 中 看 到 “hello Mike” 的 输出 。 

不 过 在 大 多 数 的 场景 里 ， 我 们 一 般 是 在 程序 里 调用 服务 ， 而 不 是 简单 地 通过 浏览 器 调用 ， 在 
下 面 的 EurekaBasicDemo-ServiceCaller 项 目 里 ， 我 们 将 演示 在 Eureka 客户 端 调用 服务 的 步骤 。 


代码 位 置 视频 位 置 


i\EurekaBasicDemo-ServerCaller 视频 \ 第 3 章 \Eureka 服务 调用 端 


第 一 步 ， 在 这 个 Maven 项 目 里 ， 编 写 如 下 的 pom.xml 配置 ， 关 键 代 码 如 下 : 


<dependencyManagement> 

2 <dependencies> 

2 <dependency> 

4 <groupId>org.springframework.cloud</groupId> 


<artifactId>spring-cloud-dependencies</artifactId> 


3 <version>Brixton.SR5</version> 
6 <type>pom</type> 

er <scope>import</scope> 

8 </dependency> 

9 </dependencies> 


10 </dependencyManagement> 
和 <dependencies> 


2 <dependency> 

3 <groupId>org.springframework.boot</groupId> 

14 <artifactId>spring-boot-starter-web</artifactId> 

15 <version>1.5.4.RELEASE</version> 

16 </dependency> 

tr! <dependency> 

18 <groupId>org.springframework.cloud</groupId> 

LD <artifactId>spring-cloud-starter-eureka</artifactId> 
20 </dependency> 

2 <dependency> 

2 <groupId>org.springframework.cloud</groupId> 

2 <artifactId>spring-cloud-starter-ribbon</artifactId> 
24 </dependency> 


25 </dependencies> 
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请 大 家 注意 ， 从 第 21~24 行 的 代码 里 ， 我 们 需要 引入 ribbon 的 依赖 包 ， 通 过 它 我 们 可 以 实现 
负载 均衡 ,在 后 继 章节 里 ,我 们 将 详细 讲述 负载 均衡 的 实现 方式 。 其 他 的 依赖 包 , 我们 之 前 都 已 经 
见 过 ， 所 以 就 不 再 解释 了 。 

第 二 步 ， 在 application.yml 里 ， 编 写 针对 本 项 目的 配置 信息 ， 代 码 如 下 : 
spring: 

application: 

name: callHello 

server: 
port: 8080 

eureka: 
client: 


serviceUrl: 
defaultZone: http://localhost:8888/eureka/ 


在 第 3 行 里 ， 我 们 指定 了 本 服务 的 名 字 叫 callHello。 在 第 5 行 里 ， 我 们 指定 了 本 服务 是 运行 
在 8080 端口 。 在 第 9 行 里 ， 我 们 把 本 服务 注册 到 Eureka 服务 器 上 。 

第 三 步 ， 编 写 提供 服务 的 控制 器 类 ， 在 其 中 调用 服务 提供 者 提供 的 服务 ， 代 码 如 下 ; 

1 // 省 略 必要 的 package 和 import 代码 


[ 


ownawmew 


2 RestController 

3  Q@Configuration 

4 public class Controller { 

5 @Bean 

6 @LoadBalanced 

Public RestTemplate getRestTemplate() 

8 { 

9 return new RestTemplate(); 

10 } 

了 证 @RequestMapping (value = "/hello"，method = RequestMethod.GET ) 

2 Public String hello() { 

3 RestTemplate template = getRestTemplate(); 

14 String retVal = template.getForEntity("http://sayHello/hello/ 
Eureka", String.class) .getBody(); 

有 return "In Caller, " + retVal7 

16 } 

二 7 小 


在 第 7 行 的 getRestTemplate 方法 上 ， 我 们 启动 了 @LoadBalanced 负载 均衡 ) 的 注解 。 

关于 负载 均衡 的 细节 将 在 后 面 章节 里 详细 描述 ， 这 里 我 们 引入 @LoadBalanced 注解 的 原因 是 ， 
RestTemplate 类 型 的 对 象 本 身 不 具备 调用 远程 服务 的 能 力 ， 如 果 我 们 去 掉 这 个 注解 ， 程 序 未 必 能 跑 
通 。 只 有 当 我 们 引入 该 注解 ， 该 方法 所 返回 的 对 象 才能 具备 调用 远程 服务 的 能 力 。 

在 提供 服务 的 第 12~16 行 的 hello 方法 里 ， 我 们 通过 第 14 行 的 代码 ， 用 RestTemplate 类 型 对 
象 的 getForEntity 方法 调用 服务 提供 者 sayHello 提供 的 hello 方法 。 这 里 我 们 通过 
http://sayHello/hello/Eureka 这 个 url 去 发 现 并 调用 对 应 的 服务 。 在 这 个 url 里 ， 只 包含 了 服务 名 
sayHello， 并 没有 包含 服务 所 在 的 主机 名 和 端口 号 。 从 中 我 们 能 看 出 ， 该 url 其 实 是 通过 注册 中 心 
定位 到 sayHello 服务 的 物理 位 置 的 。 至 于 这 个 url 和 该 服务 物理 位 置 的 绑 定 关 系 , 是 在 Eureka 内 部 
实现 的 ， 这 也 是 Eureka 可 以 被 称 作 “服务 发 现 框架 ”的 原因 。 

第 四 步 ， 在 ServiceCallerApp.java 方法 里 ， 编 写 启动 本 服务 的 代码 。 这 我 们 已 经 很 熟悉 了 ， 所 
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以 就 不 再 讲述 了 。 
// 省 略 必要 的 package 和 import 代码 


上 


2 @EnableDiscoveryClient 

3  Q@SpringBootApplication 

4 Public class ServiceCallerApp 

| 

6 Public static void main( String[] args ) 

局 由 

8 SpringApplication.run(ServiceCallerApp.class, args); 
9 . 

10 } 


3.2.4 ”通过 服务 调用 者 调用 服务 


当 我 们 依次 启动 Eureka 服务 器 (也 就 是 注册 中 心 )、 服 务 提供 者 和 服务 调用 者 的 Spring Boot 
启动 程序 后 ， 在 浏览 器 里 输入 “http://localhost:8888/” 后 ， 能 在 信息 面板 里 看 到 两 个 服务 ， 分 别 是 
服务 提供 者 sayHello 和 服务 调用 者 callHello， 如 图 3.4 所 示 。 


Instances currently registered with Eureka 


Application AMIs Availabilicty Zones Status 
CALLHELLO n/a ll) (1) UP (1) - 192.168.42.1:callHello:8080 
SAYHELLO n/all) (1) UP (1) - 192.168.42.1:sayHello:1111 


3.4 在 Eureka 信息 面板 里 能 看 到 两 个 服务 


由 于 服务 调用 者 运行 在 8080 端口 上 ， 如 果 我 们 在 浏览 器 里 输入 “http://localhost:8080/hello”， 
能 看 到 在 浏览 器 中 输出 “In Caller, hello Eureka”， 就 说 明 它 确实 已 经 调用 了 服务 提供 者 sayHello 
里 的 hello 方法 。 

此 外 ， 我 们 还 能 在 服务 提供 者 所 在 的 控制 台 里 看 到 host、port 和 ServiceID 的 输出 ， 如 图 3.5 
所 示 。 这 能 进一步 验证 服务 提供 者 控制 器 类 里 的 hello 方法 被 服务 调用 者 调用 了 。 


图 3.5 服务 提供 者 代码 的 部 分 输出 截图 
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3.3 ”实现 高 可 用 的 Eureka 集群 


在 上 文 里 ， 我 们 演示 了 Eureka 客户 端 调用 服务 的 整个 流程 ， 这 里 我 们 将 在 架构 上 有 所 改进 。 
大 家 可 以 想象 一 下 ， 在 上 文 的 案例 中 ，Eureka 注册 中 心 只 部 署 在 一 台 机 器 上 ， 这 样 一 旦 它 出 现 问 
题 ， 就 会 导致 整个 服务 调用 系统 的 骨 泪 ， 如 果 这 种 情况 发 生 在 生产 环境 上 ， 后 果 是 不 堪 设想 的 。 
大 家 别 以 为 这 是 危 言 管 听 ， 在 高 并 发 的 场景 下 (比如 双 十 一 的 并 发 环境 ) ， 这 种 情况 发 生 的 
可 能 性 不 低 。 针 对 这 种 场景 ， 这 里 我 们 将 部 署 两 台 Eureka 注册 中 心 ， 彼 此 相互 注册 ， 以 此 搭建 一 
个 可 用 性 比较 高 的 Eureka 集群 。 
| 代码 位 置 
代码 \ 第 3 章 \ ek-cluster-server 
代码 \ 第 3 章 \ ek-cluster-server-backup 
代码 \ 第 3 章 \ ek-cluster-ServiceProvider 
代码 \ 第 3 章 \ ek-cluster-ServiceCaller 


视频 \ 第 3 章 \ 搭 建 高 可 用 的 Eureka 集群 


3.3.1 ”集群 的 示意 图 
在 这 个 集群 里 , 我 们 将 配置 2 台 相互 注册 的 Eureka 服务 器 ,这样 一 来 ,每 台 服 务 器 都 包含 着 对 方 


的 服务 注册 信息 ， 相 当 于 双 机 热 备 ， 同 时 服务 提供 者 只 需 向 其 中 的 一 个 注册 服务 ， 如 图 3.6 所 示 。 
相互 注册 查找 服务 
Eureka 服 务 器 B ”一 党 Eureka 服 务 器 & Eureka 客 户 端 
(包含 注册 中 心 》 《包含 注册 中 心 ) 《服务 调用 者 》 
注册 服务 
调用 服务 

Eureka 客 户 端 
(服务 提供 者 》 


3.6 ”高 可 用 Eureka 集群 示意 图 


这 样 ， 如 果 服务 器 A 或 B 宕 机 ， 那 么 另 一 台 服 务 器 依然 可 以 向 外 部 提供 服务 列表 ， 服 务 调用 
者 依然 可 以 据 此 调用 服务 。 

在 并 发 要 求 更 高 的 环境 里 ， 我 们 甚至 可 以 搭建 2 台 以 上 的 服务 器 ， 不 过 事实 上 ， 双 机 热 备 的 
集群 能 满足 大 多 数 的 场景 : 一 方面 , 不 是 每 个 系统 的 并 发 量 都 很 高 ,所 以 双 机 热 备 足 以 满足 大 多 数 
的 并 发 需求 ; 另 一 方面 ， 毕 竟 两 台 服 务 器 同时 宕 机 的 可 能 性 也 不 大 。 


3.3.2 ”编写 相互 注册 的 服务 器 端 代 码 

这 里 为 了 演示 方便 ， 我 们 在 一 台 机 器 上 模拟 双 服 务 器 的 场景 ， 在 真实 项 目 里 ， 我 们 一 般 是 把 
两 个 相互 注册 的 服务 器 安装 在 两 台 主 机 上 ,因为 如 果 只 安装 在 一 台 上 , 那么 该 服务 器 发 生 故障 ， 两 
个 服务 器 都 会 失效 。 具 体 的 实现 步骤 如 下 。 
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步骤 014 到 C:\WINDOWS\system32\drivers\etc 目录 里 ， 找 到 hosts 文件 ， 在 其 中 加 入 两 个 机 
器 名 ( 其 实 都 是 指向 本 机 )， 代 码 如 下 。 修 改 后 ， 需 要 重启 机 器 。 


于 Eb Lt ekServerl 
2 127-05054 ekServer2 


步骤 024 创建 ek-cluster-server 项 目 ， 其 实 是 根 i 


据 3.2.1 小 节 里 的 EurekaBasicDemo-Server 项 


目 改 写 而 来 。 和 之 前 的 项 目 相 比 ， 我 们 只 改动 了 application.yml 文件 ， 代 码 如 下 : 


Server: 
port: 8888 
spring: 
application: 
name: ekServerl 
eureka: 
instance: 
hostname: ekServerl 
client: 
serviceUrl: 


PPioowawmewnP 


0 
Yl defaultZone: http://ekServer2:8889/eureka/ 


这 里 的 端口 号 没 变 , 依然 是 8888, 但 我 们 在 第 5 行 把 项 目 名 修改 成 了 ekServerl; 在 第 8 行 里 ， 
把 提供 服务 的 主机 名 也 修改 成 ekServer1; 在 第 11 行 里 ， 我 们 指定 了 本 服务 所 在 的 url， 这 里 请 注 
意 ， 我们 把 ekServerl 所 在 的 serverUrl 指定 到 ekServer2 的 8889 端口 上 ， 也 就 是 说 ， 这 里 我 们 指定 


ekServerl 向 ekServer2 注册 。 


步骤 034 在 真实 项 目 里 ， 我 们 一 般 会 在 两 台 主 机 上 启动 两 个 Eureka 服务 ， 所 以 这 里 我 们 再 


创建 一 个 Maven 类 型 的 项 目 ek-cluster-server-backup， 
还 是 在 于 application.yml， 代 码 如 下 : 


server: 
port: 8889 
spring: 
application: 
name: ekServer2 
eureka: 
instance: 
hostname: ekServer2 
client: 
0 serviceUrl: 


FFPieoowawm 必 wm 


这 里 的 配置 信息 其 实 和 刚才 的 是 对 偶 的 ， 这 里 的 
请 注意 第 11 行 , 这 里 的 serviceUrl 是 注册 到 ekServerl 


和 之 前 的 ek-cluster-server 相 比 ， 它 们 的 差别 


defaultZone: http://ekServer1:8888/eureka/ 


application 名 和 主机 名 都 叫 ekServer2， 不 过 
的 8888 端口 上 , 这 里 我 们 同样 指定 ekServer2 


向 ekServerl 注册 。 结 合 上 文 ， 至 此 我 们 实现 了 双 服 务 器 之 间 的 相互 注册 。 


3.3.3 ”服务 提供 者 只 需 向 其 中 一 台 服务 器 注册 


虽然 在 集群 里 搭建 了 两 台 服 务 器 ， 但 是 服务 提供 


者 只 需 向 其 中 的 一 台 注 册 即 可 ， 和 否则 高 可 用 
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的 便利 性 就 会 以 牺牲 代码 可 维护 性 为 代价 了 。 
这 里 我 们 是 在 ek-cluster-ServiceProvider 项 目 编写 服务 提供 程序 , 它 是 根据 上 文 3.2.2 小 节 里 的 
项 目 EurekaBasicDemo-ServerProvider 改写 而 来 的 ， 其 中 只 修改 了 application.yml 部 分 的 代码 。 


server: 
PorzE ITL 
spring: 
application: 
name: sayHello 
eureka: 
client: 
serviceUrl: 
defaultZone: http://ekServerl:8888/eureka/ 


我 们 只 改动 了 第 9 行 的 代码 ， 这 说 明 本 服务 是 向 ekServerl 的 8888 号 端口 注册 。 
由 于 这 里 两 个 Eureka 服务 器 是 相互 注册 的 ， 因 此 本 服务 提供 者 无 须 同时 向 两 个 服务 器 注册 ， 
一 旦 向 ekServerl 注册 后 ， 该 服务 器 就 会 自动 把 服务 提供 者 的 信息 复制 到 ekServer2 上 。 


上 


CoanwN 


3.3.4 ”修改 服务 调用 者 的 代码 


我 们 把 服务 调用 者 的 代码 放 入 ek-cluster-ServiceCaller 这 个 Maven 项 目 里 , 这 是 根据 之 前 3.2.3 
小 节 里 的 EurekaBasicDemo-ServerCaller 项 目 改 写 而 来 的 。 其 中 ， 我 们 也 只 修改 application.yml 代 
码 。 
下 spring: 
2 application: 
| name: callHello 
4 server; 
5 port: 8080 
6 eureka: 
gi client: 
8 serviceUrl: 
9 defaultZone: http://ekServerl:8888/eureka/ 
改动 点 还 是 在 第 9 行 上 ， 这 里 是 向 ekServerl 服务 器 的 8888 号 端口 注册 。 同 理 ， 这 里 也 无 须 
向 另外 一 个 机 器 (ekServer2) 注册 。 


3.3.5 “正常 场景 下 的 运行 效果 


按 如 下 次 序 启动 4 个 项 目的 Spring Boot 服务 。 


第 一 ，ek-cluster-server (第 一 个 Eureka 服务 器 ) 。 

第 二 ，ek-cluster-server-backup 〈 第 二 个 Eureka 服务 器 ) 。 
第 三 ，ek-cluster-ServiceProvider 〔〈 服 务 提供 者 ) 。 

第 四 ，ek-cluster-ServiceCaller〈 服 务 调 用 者 ) 。 


随后 ， 大 家 能 在 http://ekserver1:8888/ 和 http://ekserver2:8889/ 两 个 浏览 器 上 看 到 如 图 3.7 所 示 
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的 4 个 可 用 服务 。 由 于 是 相互 注册 ， 因 此 它们 的 内 容 是 一 样 的 。 


Instances currently registered with Eureka 
Application AMIs Availability Zones Status 


CALLHELLO nall) (1 UP(D- 


EKSERVER1 n/all) (0 UP(D- 


EKSERVER2 n/all) (y UP(D- 


SAYHELLO n/all) (人 UP(1) - 192. 


3.7 集群 运行 后 的 效果 图 


2.1:sayHello:1111 


虽然 这 里 我 们 也 可 以 通过 http://localhost:8888/ 和 http://localhost:8889/ 看 到 相同 的 效果 , 但 是 不 
推荐 。 这 是 因为 ， 在 真实 的 项 目 里 ，Eureka 的 服务 器 应 该 是 和 开发 机 器 分 开 的 ， 也 就 是 说 它们 应 
该 被 部 署 在 其 他 机 器 上 ， 只 不 过 这 里 我 们 为 了 演示 方便 ， 把 它们 都 放 在 了 本 机 中 。 

当 我 们 确认 服务 启动 后 ， 可 以 在 浏览 器 里 输入 “http:/Wekserverl:8080/hello ”来 查看 服务 调用 的 
效果 ， 这 里 其 实 触 发 了 ek-cluster-ServiceCaller 中 Controller 里 的 hello 方法 。 

和 之 前 一 样 ， 这 里 的 输出 还 是 “In Caller, hello Eureka”， 这 说 明 双 机 热 备 的 Eureka 架构 至 少 
不 会 影响 基本 的 功能 。 同 样 ， 这 里 不 建议 通过 http://localhost:8080/hello 来 查看 运行 效果 。 


3.3.6 一 台 服 务 器 宕 机 后 的 运行 效果 


这 里 我 们 可 以 故意 关闭 ek-cluster-server 服务 ， 以 此 来 模拟 一 台 服务 器 宕 机 的 情况 。 

关闭 后 ,我 们 在 浏览 器 里 输入 “http://ekserver1:8080/hello”， 虽 然 我们 在 服务 提供 者 和 服务 调 
用 者 的 application.yml 里 指定 的 serviceUrl.defaultZone 都 是 http://ekServer1:8888/eureka/, 但 是 在 一 
台 Eureka 服务 器 失效 的 情况 下 ， 我 们 依然 能 看 到 正确 的 结果 ， 如 图 3.8 所 示 。 


Cy A ekserverl 


|> 3 谷歌 转 网 直 大 全 〇 360 搜 索 侠 游 戏 中 心 国 册 crosoft 链接 


In Caller, hello Eureka 


3.8 一 台 Eureka 服务 器 宕 机 后 的 效果 图 


如 果 在 刚才 关闭 的 是 ek-cluster-server-backup， 让 ek-cluster-server 运行 ， 这 里 我 们 还 是 能 看 到 
同样 的 效果 。 也 就 是 说 ， 在 这 个 Eureka 双 服务 器 的 集群 里 ， 一 台 服 务 器 宕 机 后 ， 整 个 服务 体系 依 
然 可 用 ， 这 就 大 大 提升 了 系统 的 可 用 性 。 


3.4 ”Eureka 的 常用 配置 信息 


这 里 我 们 将 讲述 查看 Eureka 客户 端 和 服务 器 端 配置 信息 的 方法 ， 并 在 此 基础 上 讲述 一 些 项 目 
里 常用 的 配置 参数 的 用 法 。 
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3.4.1 查看 客户 端 和 服务 器 端的 配置 信息 


在 作者 的 机 器 上 ， 本 地 仓库 在 C:\Documents and Settings\Administraton.m2\ 中 ， 所 以 之 后 的 叙 
述 就 以 此 为 准 ， 大 家 可 以 对 应 地 找到 自己 Maven 的 本 地 仓库 。 

在 ~./.m2\repository\org\springframework\cloud\spring-cloud-netflix-eureka-client\1.3.1.RELEASE 
这 个 目录 里 , 可 以 看 到 spring-cloud-netflix-eureka-client-1.3.1.RELEASE.jar 文件 , 在 大 家 的 机 器 上 ， 
也 能 找到 版 本 号 相同 或 不 同 的 这 个 jar 包 。 

解 开 这 个 jar 文件 ， 能 在 META-INF 目录 里 找到 spring-configuration-metadata.json， 在 其 中 就 
用 json 格式 的 文件 记录 了 所 有 的 Eureka 客户 端的 配置 信息 ， 我 们 来 看 一 下 部 分 代码 。 


| 

加 "sourceType": "org.springframework.cloud.netflix.eureka. 
EurekaClientConfigBean", 

| "defaultValue": false, 

4 "name": "eureka.client.allow-redirects", 

5 "description": 省 略 关 于 该 属性 的 描述 ， 

6 "type": "java.lang.Boolean" 

到 } 


在 第 4 行 中 ， 我 们 能 看 到 该 属性 的 名 字 ， 即 eureka.client.allow-redirects; 第 2 行 代码 定义 了 该 
属性 所 在 的 类 名 ;在 第 3 行 代码 定义 了 该 属性 的 默认 值 ; 第 6 行 定义 了 该 属性 的 类 型 。 

同样 的 ,在 作者 机 器 上 也 存在 着 spring-cloud-netflix-eureka-server-1.3.1.RELEASE.jar 这 个 文件 ， 
解 开 它 之 后 ， 在 META-INF 目录 里 能 看 到 spring-configuration-metadatajson， 在 其 中 包含 着 服务 器 
端的 所 有 配置 信息 。 


3.4.2 ”设置 心跳 检测 的 时 间 周期 


Eureka 客户 端 会 定时 向 服务 器 端 发 送 心 跳 ， 以 此 证 明 该 站 点 可 用 ， 这 个 值 默 认 是 30 秒 ， 在 实 
际 应 用 里 ， 我 们 可 以 通过 修改 eureka.instance.lease-renewal-interval-in-seconds 属性 来 改变 这 个 值 。 
具体 的 做 法 是 ， 在 客户 端的 application.yml 里 ， 添 加 如 下 部 分 的 代码 。 

1 eureka: 

2 instance: 

3 lease-renewal-interval-in-seconds: 60 

关于 心跳 ， 还 有 另外 一 个 lease-expiration-duration-in-seconds 属性 ， 默 认 是 90 秒 ， 这 说 明 如 果 
服务 器 端 有 90 秒 没收 到 客户 端的 心跳 ， 就 会 把 它 从 服务 列表 里 删除 。 


3.4.3 ”设置 自我 保护 模式 


在 Eureka 服务 器 端 ， 我 们 能 看 到 eureka.server.enable-self-preservation 参数 ， 用 它 可 以 指定 是 
和 否 启 动 保护 模式 ， 默 认 值 是 true。 

从 上 文中 我 们 已 经 知道 ， 如 果 Eureka 服务 端 在 一 定 的 时 间 段 内 没有 接收 到 某 个 客户 端 服务 提 
供 者 实例 的 心跳 ， 那 么 Eureka 服务 端 将 注销 该 实例 ， 这 个 时 间 段 的 默认 值 是 90 秒 。 
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这 样 做 能 避免 因 服务 不 可 用 而 导致 的 “错误 扩展 ”， 从 而 能 把 错误 的 影响 控制 在 一 个 较 小 的 
范围 内 。 但 现实 中 可 能 会 发 生 这 种 情况 : 服务 器 端 和 客户 端 之 间 联 系 不 上 不 是 因为 客户 端 服务 不 可 
用 ， 而 是 因为 当前 网 络 确实 有 故障 (服务 提供 者 本 身 没 问 题 ) ， 这 时 就 不 应 当 注 销 服务 了 。 

Eureka 服务 器 能 通过 “自我 保护 模式 ”来 处 理 这 类 问题 ， 根 据 官 方 文档 ， 如 果 在 15 分 钟 内 ， 
超过 85% 的 客户 端 实例 都 没有 发 来 正常 的 心跳 ， 那 么 Eureka 服务 器 就 认为 出 现 了 网 络 故障 ， 这 时 
就 会 进入 自我 保护 模式 。 

进入 该 模式 后 ，Eureka Server 就 会 保护 服务 注册 表 中 的 信息 ， 不 再 继续 删除 注册 中 心里 的 服 
务 列 表 数 据 。 当 网 络 故障 恢复 后 ， 就 会 自动 退出 自我 保护 模式 。 

从 上 述 描述 来 看 ， 自 我 保护 模式 能 提升 Eureka 集群 的 健壮 性 ， 所 以 如 果 没 有 特殊 的 情况 ， 不 
建议 通过 把 eureka.server.enable-self-preservation 设置 成 false 来 关闭 自我 保护 模式 。 


3.4.4 其 他 常用 配置 信息 


在 表 3.1 里 ， 我 们 归纳 了 在 客户 端 常用 的 一 些 配置 信息 ， 它 们 一 般 是 配置 在 Eureka 客户 端 。 
表 3.1 Eureka 客户 端 常用 配置 信息 归纳 表 


参数 值 描述 

实例 变更 后 复制 到 Eureka 服务 器 所 需 的 时 间 间 隔 ， 
默认 为 30 秒 

Eureka 客户 端 所 允许 的 所 有 Eureka 服务 器 连接 的 总 
数 ， 默 认 是 200。 注 意 ， 这 里 指 的 是 所 有 服务 器 


Eureka 客户 端 所 允许 的 Eureka 单 台 服务 器 连接 的 总 
数 ， 默 认 是 50。 注 意 ， 这 里 指 的 是 单 台 


该 实例 是 否 需要 在 eureka 服务 器 上 注册 ,默认 是 true 


申请 服务 的 HTTP 请 求 的 最 长 等 待 时 间 ， 默 认为 
eureka.client.eureka-connection-idle-timeout-seconds ”| 30 秒 , 如 果 30 秒 内 该 HTTP 请 求 没 有 任何 动作 ， 就 
会 自动 断 开 连接 


是 否 获取 Eureka 服务 器 注册 中 心 上 的 所 有 服务 的 注 
册 信 息 ， 默 认为 true 


在 表 3.2 里 ， 我 们 归纳 了 在 服务 器 端 常 用 的 一 些 配 置信 息 ， 这 些 参 数 的 影响 面 都 比较 大 ， 所 以 
没有 特殊 理由 ， 不 建议 修改 。 同 样 的 ， 服 务 端的 参数 一 般 都 会 用 默认 值 ， 没 事 不 会 轻易 修改 。 
表 3.2 ”Eureka 服务 器 端 常用 配置 信息 归纳 表 
参数 值 描述 
开启 自我 保护 模式 的 阔 值 因子 ， 默 认 是 0.85， 比 如 

eureka.server.renewal-percent-threshold 在 15 分 钟 内 ， 有 85% 的 客户 端 服务 不 可 用 ， 则 开 
启 自 我 保护 模式 
关于 自我 保护 模式 中 闪 值 更 新 的 时 间 间 隔 , 单位 为 
毫秒 


a 其 被 保存 在 缓存 中 不 失效 的 时 间 ， 默 认为 180 秒 


eureka.client.instance-info-replication-interval-seconds 


eureka.client.eureka-server-total-connections 


eureka.client.fetch-registry 


eureka.server.renewal-threshold-update-interval-ms 
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3.5 本 章 小 结 


在 这 个 章节 里 , 我们 不 仅 学 习 了 Eureka 各 部 分 组 件 的 基本 用 法 ,更 了 解 了 在 项 目 里 搭建 Eureka 
架构 的 基本 步骤 。 从 本 章 给 出 的 架构 案例 中 ,我 们 能 看 到 ， 高 可 用 的 架构 确实 能 降低 系统 因 宕 机 而 
造成 的 风险 。 换 名 话说， 大 家 从 这 个 章节 里 已 经 开始 接触 架构 师 所 需要 的 技能 点 。 

这 只 是 一 个 开始 ， 在 本 书 的 后 继 章节 里 ， 还 将 进一步 讲解 其 他 诸如 “负载 均衡 ”之 类 的 和 架 
构 相 关 的 知识 点 。 大 家 在 后 继 的 学 习 中 ， 除 了 得 了 解 其 他 相关 组 件 的 用 法 之 外 ， 还 得 留意 “集群 ” 
和 “架构 ”方面 的 知识 点 。 当 然 ， 遇 到 这 样 比较 “值钱 ”的 知识 点 ， 作 者 会 给 出 提示 ， 以 引起 大 家 
的 重视 。 


第 4 章 


负 载 均 衡 组 件 : Ribbon 


在 一 些 高 并 发 的 分 布 式 系统 里 ， 往 往 会 用 多 台 服 务 器 搭建 成 集群 ， 以 此 来 均衡 系统 访问 量 ， 
对 此 大 家 可 以 参考 第 3 章 Eureka 的 例子 。 但 即使 搭建 集群 ， 如 果 不 做 任何 配置 ， 系 统 依然 无 法 把 
流量 有 效 地 分 挫 到 各 服务 器 上 。 

负载 均衡 可 以 在 硬件 层 和 软件 层 实 现 ， 对 于 一 些 有 分 布 式 需求 但 并 发 量 不 是 特别 高 的 系统 而 
言 ， 用 软件 层 的 即 可 。 在 Spring Cloud 的 诸多 组 件 里 ，Ribbon 能 提供 负载 均衡 的 功能 ， 事 实 上 ， 
它 足 以 满足 大 多 数 系统 的 负载 均衡 需求 。 


4.1 网 络 协议 和 负载 均衡 


虽然 说 Spring Cloud 里 的 Ribbon 组 件 向 大 家 屏蔽 了 在 网 络 协议 层面 的 实现 细节 ， 但 如 果 大 家 
了 解 了 这 些 细节 ， 就 将 会 更 好 地 了 解 负载 均衡 的 实现 原理 。 而 且 ， 对 于 资深 架构 师 而 言 ， 可 能 不 仅 
仅 限 于 现 有 的 负载 均衡 组 件 〈 比 如 Ribbon) ， 更 得 结合 诸多 组 件 的 优势 创建 一 套 适 合 本 项 目的 实 
现 方案 ， 这 就 更 得 对 底层 的 网 络 协议 有 深刻 的 了 解 了 。 


4.1.1 基于 4 层 和 7 层 的 负载 均衡 策略 


所 有 的 负载 均衡 硬件 或 软件 都 是 作用 在 网 络 通信 协议 之 上 的 ， 当 前 我 们 的 网 络 是 运行 在 如 图 
4.1 所 示 的 OSI 七 层 网 络 协议 之 上 的 。 

从 上 往 下 分 别 是 应 用 层 、 表 示 层 、 会 话 层 、 传 输 层 、 网 络 层 、 数 据 链 路 层 和 物理 层 ， 其 中 ， 
我 们 比较 熟悉 的 TCP/IP 或 UDP 协议 工作 在 第 4 层 ， 即 传输 层 ; 而 HTTP、FTP、Telnet 和 SMTP 
等 常用 的 协议 则 是 在 第 7 层 ， 即 物理 层 。 
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应 用 层 应 用 层 

表示 层 表示 层 
记 会 雪 ] 会 话 层 
记念 葵 层 | 本 
[网 络 层 | 网 络 层 
[要 据 链 路 层 ] 数据 镑 路 层 
| 理 展 《比如 光纤 等 硬件 ) 


4.1 OSI 七 层 网 络 协议 结构 图 


一 般 来 讲 ， 负 载 均衡 主要 有 4 层 交 换 (L4 switch) 和 7 层 交换 (L7 switch) 之 分 ， 这 些 术 语 
是 针对 上 述 网 络 协议 而 言 的 , 具体 而 言 ,是 指 在 进行 负载 均衡 时 是 在 第 4 层 还 是 在 第 7 层 转发 请 求 。 

针对 4 层 的 负载 均衡 策略 是 基于 TCP/IP 协议 来 实现 的 ,比如 可 以 根据 IP 地 址 和 端口 号 决定 转 
发 的 规则 ; 针对 7 层 的 策略 可 以 根据 请 求 中 基于 HTTP 协议 的 信息 来 转发 ， 比 如 可 以 根据 HTTP 
信息 头 里 包含 的 操作 系统 类 型 来 进行 转发 。 

从 应 用 角度 来 看 ， 基 于 4 层 和 7 层 的 负载 均衡 技术 最 大 的 差别 在 于 功能 与 效率 。 基 于 4 层 的 
方案 由 于 无 须 解析 基于 应 用 层 的 消息 内 容 , 因此 简单 高 效 ; 基于 7 层 的 方案 则 能 根据 具体 的 业务 场 
景 来 进行 分 发 ， 所 以 功能 比较 强大 ,但 代价 比较 昂贵 。 所 以 在 选用 时 ,其实 没有 优 劣 之 分 ， 还 得 根 
据 具体 的 需求 场景 来 综合 考虑 。 


4.1.2 ”硬件 层 和 软件 层 的 负载 均衡 方案 比较 


硬件 方面 的 解决 方案 一 般 是 指 在 服务 器 和 网 络 之 问 配 置 负载 均衡 器 ， 让 专门 的 硬件 设备 完成 
分 发 流量 的 任务 。 在 这 种 解决 方案 里 ， 我 们 可 以 给 负载 均衡 器 配置 针对 项 目的 专 有 负载 均衡 策略 ， 
从 而 达到 很 好 的 效果 。 相 比 软件 层 的 解决 方案 ， 负 载 均衡 器 效果 较 好 ， 但 价格 比较 高 。 

基于 软件 的 负载 均衡 是 指 在 一 台 或 多 台 服 务 器 上 安装 专门 的 软件 来 实现 均衡 流量 的 效果 。 一 
般 来 说 ， 它 的 成 本 比较 低廉 ， 所 以 能 根据 实际 需求 增加 或 更 改 负载 均衡 机 器 的 数量 , 但 同 能 的 情况 
下 ， 效 果 没有 硬件 来 的 好 。 

在 大 多 数 的 应 用 场景 里 ， 对 负载 均衡 要 求 不 会 特别 高 ， 所 以 说 ， 基 于 软件 的 方案 足以 满足 大 
多 数 的 需求 。 

常见 的 硬件 负载 均衡 器 有 思科 和 BIG-IP 系列 产品 。 常 见 的 负载 均衡 软件 有 LVS 和 Nginx， 其 
中 LVS 工作 在 4 层 ， 而 Nginx 则 可 以 工作 在 7 层 。 


4.1.3 常见 的 软件 负载 均衡 策略 


一 般 来 说 ， 负 载 均衡 软件 会 用 如 下 4 种 策略 来 把 请 求 分 派 到 集群 中 的 服务 器 上 。 
第 一 ， 轮 询 策略 。 这 种 策略 的 原理 非常 简单 ， 把 请 求 依次 派发 到 服务 器 节点 上 ， 这 适用 于 各 
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个 服务 节 处 理 请 求 的 能 力 都 相同 的 场景 。 

第 二 ， 随 机 策略 。 这 与 轮 询 相 似 ， 只 是 不 需要 对 每 个 请 求 进行 编 号 ， 每 次 随机 取 一 个 。 同 样 
地 ， 该 策略 也 将 每 个 服务 器 节点 视 为 等 同 的 。 

第 三 ， 最 小 响应 时 间 策 略 。 在 这 种 策略 里 ， 将 计算 出 每 个 服务 节点 的 平均 响应 时 间 ， 以 此 来 
选择 响应 时 间 最 小 的 服务 器 。 该 策略 能 较 好 地 根据 服务 器 的 情况 做 动态 调整 , 但 时 间 上 会 有 些 延 后 ， 
可 能 无 法 更 好 地 适应 高 并 发 流量 的 场景 。 

第 四 ， 最 小 并 发 数 策略 。 在 这 种 策略 里 ， 记 录 了 当前 时 刻 每 个 节点 正在 处 理 的 请 求 数量 ， 然 
后 选择 并 发 数 最 小 的 节点 。 该 策略 实现 起 来 较为 复杂 ， 但 能 合理 地 分 配 负载 。 


4.1.4 ”Ribbon 组 件 基本 介绍 


Ribbon 是 Spring Cloud Netflix 全 家 桶 中 负责 负载 均衡 的 组 件 , 是 一 组 类 库 的 集合 .通过 Ribbon， 
程序 员 能 在 不 涉及 具体 实现 细节 的 基础 上 “透明 ”地 用 到 负载 均衡 ， 而 不 必 在 项 目 里 过 多 地 编写 实 
现 负 载 均衡 的 代码 。 

比如 ， 在 某 个 包含 Eureka 和 Ribbon 的 集群 中 ， 某 个 服务 (可 以 理解 成 一 个 jar 包 ) 被 部 署 在 
多 台 服 务 器 上 ， 当 多 个 服务 使 用 者 同时 调用 该 服务 时 , 这 些 并 发 的 请 求 能 被 用 一 种 合理 的 策略 转发 
到 各 台 服 务 器 上 。 

事实 上 ， 在 使 用 Spring Cloud 的 其 他 各 种 组 件 时 ， 我 们 都 能 看 到 Ribbon 的 痕迹 ， 比 如 Eureka 
能 和 Ribbon 整合 ,而 在 后 文 里 将 提 到 的 提供 网 关 功 能 Zuul 组 件 在 转发 请 求 时, 也 可 以 整合 Ribbon， 
从 而 达到 负载 均衡 的 效果 。 

从 代码 层面 来 看 ，Ribbon 有 如 下 3 个 比较 重要 的 接口 。 

第 一 ，IloadBalancer。 这 也 叫 负载 均衡 器 ， 通 过 它 ， 我 们 能 在 项 目 里 根据 特定 的 规则 合理 地 转 
发 请 求 。ILoadBalancer 是 一 个 接口 ， 常 见 的 实现 类 有 BaseLoadBalancer。 

第 二 ，IRule。 这 个 接口 有 多 个 实现 类 ， 比 如 RandomRule 和 RoundRobinRule， 这 些 实现 类 具 
体 地 定义 了 诸如 “随机 ”和 “ 轮 询 ” 等 的 负载 均衡 策略 。 此 外 ， 我 们 还 能 重 写 该 接口 里 的 方法 来 自 
定义 负载 均衡 的 策略 。 

第 三 ，IPing 接口 。 通 过 该 接口 ， 我 们 能 获取 到 当前 哪些 服务 器 是 可 用 的 ， 也 能 通过 重 写 该 接 
口 里 的 方法 来 自 定义 判断 服务 器 是 否 可 用 的 规则 。 

当然 ， 还 有 ServerList、ServerListFilter、ServerListUpdate 和 DynamicServerListLoadbalancer 
等 其 他 接口 和 类 , 不 能 说 它们 不 重要 , 但 它们 比较 偏重 于 底层 实现 , 在 一 般 项 目 里 出 现 的 概率 不 高 ， 
所 以 在 本 章 中 不 会 详细 讲述 它们 。 


4.2 ”编号 基本 的 负载 均衡 程序 


虽然 在 实际 项 目 里 ，Ribbon 经 常 是 和 其 他 组 件 配套 使 用 的 ， 但 在 这 里 ， 为 了 让 大 家 感性 地 体 
会 到 负载 均衡 的 实际 效果 和 开发 方式 ， 所 以 在 这 里 将 基于 Ribbon 独立 地 实现 负载 均衡 功能 。 
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4.2.1 编写 服务 器 端的 代码 


在 3.3 节 里 , 我 们 编写 了 高 可 用 的 Eureka 集群 ,启动 后 能 以 如 下 两 个 不 同 的 url 形式 向 外 界 提 
供 服务 。 


1 http://ekserverl:8080/hello 
2 http://ekserver2:8080/hello 


大 家 可 以 把 它们 想象 成 是 两 个 不 同 的 服务 器 ， 当 外 部 的 请 求 较 频繁 时 ， 我 们 可 以 把 请 求 分 发 
到 这 两 台 服 务 器 上 ， 以 提升 系统 处 理 高 并 发 请 求 的 能 力 ， 如 图 4.2 所 示 。 


RestClient 
客户 端 


畏 辐 


负载 均衡 器 


A \ 


ekServerl:8080 ekServer2:8080 
图 4.2 第 一 个 负载 均衡 代码 的 示意 图 


4.2.2 ”编写 客户 端 调用 的 代码 


视频 第 4 章 \ 负 载 均衡 基础 案例 分 析 


步骤 014 创建 名 为 RabbionBasicDemo 的 Maven 项 目 ， 在 其 中 的 pom.xml 里 ， 编 写 Ribbon 
的 依赖 包 ， 关 键 代码 如 下 : 


1 <groupId>com.springboot</groupId> 

2 <artifactId>RabbionBasicDemo</artifactId> 

3 <version>0.0.1-SNAPSHOT</version> 

4 <packaging>jar</packaging> 

3 <dependencies> 

6 <dependency> 

1 <groupId>com.netflix.ribbon</groupId> 
8 <artifactId>ribbon-core</artifactId> 
四 <version>2.2.0</version> 

10 </dependency> 

证 <dependency> 

2 <groupId>com.netflix.ribbon</groupId> 
3 <artifactId>ribbon-httpclient</artifactId> 
14 <version>2.2.0</version> 

5 </dependency> 


16 省 略 非 关键 的 代码 

1 </dependencies> 

在 第 2~4 行 里 ， 我 们 定义 了 该 项 目的 名 字 、 所 用 版 本 号 以 及 打包 方式 等 关键 信息 。 在 第 6~10 
行 里 ， 我 们 引入 了 Ribbon-Core 模块 ， 在 其 中 包含 了 负载 均衡 器 等 关键 接口 和 API 的 定义 。 在 第 
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11~15 行 中 , 我 们 引入 了 ribbon-httpclient 模块 , 在 该 模块 里 提供 了 包含 负载 均衡 功能 的 HTTP 客户 
端的 调用 方法 。 
步 又 024 编写 基于 负载 均衡 策略 的 客户 端 调 用 类 RibbonDemo.java， 代 码 如 下 。 


1 “// 省 略 必 要 的 package 和 import 方法 
2 public class RibbonDemof 
3 Public static void main( String[] args ) throws Exception 
4 上 
5 // 定 义 基于 Rest 的 客户 端 
6 RestClient client = (RestClient)ClientFactory.getNamedClient 
("RibbonDemo"); 
可 HttpRequest request = HttpRequest.newBuilder() .uri (new 
URI ("/hello")) .build(); 
8 // 设 置 负载 均衡 的 属性 
9 ConfigurationManager.getConfigInstance() .setProperty ("RibbonDemo. 
ribbon.listOfServers", "ekserverl:8080,ekserver2:8080"); 
10 // 为 了 避免 频繁 访问 而 导致 的 服务 失效 ， 睡 卢 3 秒 
二 Thread.sleep(5000); 
2 // 向 2 个 服务 器 发 出 调用 10 次 的 请 求 
3 tor(int dm Oi < LO i t+ 
14 HttpResponse response = 
client.executeWithLoadBalancer (request); 
Ls // 输 出 每 次 访问 的 状态 ， 其 中 包含 访问 的 服务 器 
16 System.out.Println ("Status for URI:" + response.getRequestedURI () 
+ " is :" + response.getstatus()); 
宙 // 输 出 返回 结果 
18 System.out .Println("Result is:" + 
response.getEntity(String.class)); 
19 } 
20 } 
-+ 


在 第 6 行 里 ， 我 们 通过 工厂 模式 生成 了 一 个 RestClient 类 型 的 client 类 ， 通 过 这 个 类 提供 的 
executeWithLoadBalancer 方法 ,我 们 可 以 把 请 求 平 摊 到 两 台 服 务 器 上 。 在 第 7 行 里 , 我们 创建 了 一 
个 HttpRequest 类 型 的 request 请 求 ， 通 过 request 对 象 定义 url 请 求 的 后 级 是 “/hello”。 

在 第 9 行 里 ， 我 们 通过 RibbonDemo.ribbon.listOfServers 这 个 属性 设置 了 两 台 可 供 负载 均衡 选 
择 的 服务 器 ， 它 们 分 别 指向 了 注册 到 Eureka 服务 器 能 提供 服务 的 两 个 地 址 。 在 实际 的 项 目 里 ， 可 
以 把 这 两 台 服 务 器 的 地 址 写 入 配置 文件 里 。 

为 了 更 好 地 演示 负载 均衡 的 效果 ， 我 们 在 第 11 行 里 让 线程 睡眠 5 秒 。 在 第 13~19 行 的 for 循 
环 里 ， 我 们 发 起 了 10 次 请 求 调用 。 具 体 而 言 ， 在 第 14 行 ， 通 过 client 的 executeWithLoadBalancer 
方法 ， 以 负载 均衡 的 方式 向 ekserver1:8080/hello 和 ekserver2:8080/hello 发 起 请 求 ， 并 用 response 
对 象 来 接收 返回 结果 。 之 后 ， 在 第 16 行 ， 我 们 输出 了 返回 状态 ， 均 是 200， 表 示 正 常 访问 ， 在 第 
18 行 ， 我 们 输出 了 调用 服务 的 结果 。 

如 果 大 家 在 自己 机 器 上 运行 这 段 代 码 ， 就 会 发 现 for 循环 里 的 请 求 被 分 摊 到 两 个 服务 器 上 ， 而 
不 是 让 某 台 服务 器 过 多 地 承担 。 如 果 把 循环 次 数 修改 成 100 次 ， 那 么 能 更 清晰 地 看 到 这 个 效果 。 
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4.3 Ribbon 中 重要 组 件 的 用 法 


在 之 前 的 案例 中 , 我们 用 RestClient 对 象 的 executeWithLoadBalancer 方法 实现 了 基本 的 负载 均 
衡 功能 。 事 实 上 ， 通 过 Ribbon 提供 的 组 件 ， 我 们 能 更 好 地 实现 负载 均衡 的 效果 。 这 里 我 们 将 依次 
讲述 它 的 各 种 重要 组 件 。 


4.3.1 


ILoadBalancer: 负载 均衡 器 接口 


在 前 文 里 ,我 们 通过 RestClient 类 型 对 象 的 executeWithLoadBalancer 方法 来 实现 基于 负载 均衡 
的 请 求 的 调用 , 在 Ribbon 里 , 我 们 还 可 以 通过 ILoadBalancer 这 个 接口 以 基于 特定 的 负载 均衡 策略 


来 选择 服务 器 。 


通过 下 面 的 ILoadBalancerDemo.java， 我 们 来 看 一 下 这 个 接口 的 基本 用 法 。 这 个 类 放 在 4.2 节 
创建 的 RabbionBasicDemo 项 目 里 ， 代 码 如 下 : 
// 省 略 必 要 的 package 和 import 代码 


public class ILoadBalancerDemo { 


ovwamumewNP 


} 


Public static void main(String[] args){ 


// 创 建 ITLoadBalancer 的 对 象 
ILoadBalancer loadBalancer = new BaseLoadBalancer () 
// 定 义 一 个 服务 器 列表 
List<Server> myServers = new ArrayList<Server> () 7 
// 创 建 两 个 Server 对 象 
Server sl = new Server("ekserverl",8080); 
Server s2 = new Server("ekserver2",8080); 
// 两 个 server 对 象 放 入 List 类 型 的 myServers 对 象 里 
myServers.add(s1); 
myServers.add(s2); 
// 把 myServers 放 入 负载 均衡 器 
loadBalancer.addServers (myServers); 
// 在 for 循环 里 发 起 10 次 调用 
for (int i=0;i<10;i++){ 
// 用 基于 默认 的 负载 均衡 规则 获得 Server 类 型 的 对 象 
Server s = loadBalancer.chooseServer ("default"); 
// 输 出 IP 地 址 和 端口 号 
System.out.println(s.getHost() + ":" + s.getPort()); 
} 


在 第 5 行 里 ， 我 们 创建 了 BaseLoadBalancer 类 型 的 loadBalancer 对 象 ， 而 BaseLoadBalancer 
是 负载 均衡 器 ILoadBalancer 接口 的 实现 类 。 

在 第 6~13 行 里 ， 我 们 创建 了 两 个 Server 类 型 的 对 象 ， 并 把 它们 放 入 myServers 里 。 在 第 15 
行 里 ， 我 们 把 List 类 型 的 myServers 对 象 放 入 了 负载 均衡 器 里 。 

在 第 17~22 行 的 for 循环 里 ， 我 们 通过 负载 均衡 器 模拟 了 10 次 选择 服务 器 的 动作 。 具 体 而 言 ， 


nl 


在 第 19 行 里 ， 通 过 loadBalancer 的 chooseServer 方 法 以 默认 的 负载 均衡 规则 选择 服务 器 ， 在 第 21 
行 里 ， 用 “打印 ”这 个 动作 来 模拟 实际 的 “使 用 Server 对 象 处 理 请 求 ” 的 动作 。 

上 述 代 码 的 运行 结果 如 下 所 示 ，loadBalancer 这 个 负载 均衡 器 把 10 次 请 求 均 挫 到 了 两 台 服 务 
器 上 ， 从 中 确实 能 看 到 “负载 均衡 ”的 效果 。 


ekserver2 
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4.3.2 ”IRule: 定义 负载 均衡 规则 的 接口 


在 上 文 里 我 们 提 到 了 负载 均衡 的 一 些 规则 ， 在 Ribbon 里 ， 我 们 可 以 通过 定义 IRule 接口 的 实 
现 类 来 给 负载 均衡 器 设置 相应 的 规则 。 在 表 4.1 里 ， 我 们 能 看 到 IRule 接口 的 一 些 常用 的 实现 类 。 


表 4.1 IRule 的 实现 类 归纳 表 


实现 类 的 名 字 
RandomRule 


RetryRule 


RoundRobinRule 


AvailabilityFilterRule 
WeightedResponseTimeRule 


ZoneAvoidanceRule 


负载 均衡 的 规则 


根据 平均 响应 时 间 为 每 个 服务 器 设置 一 个 权重 ,根据 该 权重 值 
优先 选择 平均 响应 时 间 较 小 的 服务 器 
优先 把 请 求 分 配 到 和 该 请 求 具有 相同 区 域 《Zone》 的 服务 器 上 

在 下 面 的 IRuleDemo.java 的 程序 里 , 我 们 来 看 一 下 IRule 的 基本 用 法 。 同样 ， 这 个 类 是 放 在 项 


目 里 的 。 
1 “// 省 略 必 要 的 package 和 import 代码 
2 public class IRuleDemo { 
Public static void main(String[] args){ 
4 // 请 注意 这 时 用 到 的 是 BaseLoadBalancer， 而 不 是 ILoadBalancer 接口 
5 BaseLoadBalancer loadBalancer = new BaseLoadBalancer (); 
6 // 声 明基 于 轮 询 的 负载 均衡 策略 
了 IRule rule = new RoundRobinRule () 7 
8 // 在 负载 均衡 器 里 设置 策略 
9 loadBalancer .setRule (rule) 7 
10 // 如 下 定义 3 个 server， 并 把 它们 放 入 List 类 型 的 集合 中 
了 List<Server> myServers = new ArrayList<Server> () 
12 Server sl = new Server("ekserverl",8080); 
3 Server s2 = new Server("ekserver2",8080); 
14 Server s3 = new Server("ekserver3",8080); 
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TS myServers.add(s1); 

16 myServers.add(s2); 

hy myServers.add(s3); 

18 // 在 负载 均衡 器 里 设置 服务 器 的 List 

19 loadBalancer.addServers (myServers); 

20 // 输 出 负载 均衡 的 结果 

汉王 for(int i=0;i<10744++){ 

22 Server s = loadBalancer.chooseServer (nul1) 7 
23 System.out .Println(s.getHost() + ":" + s.getPort ()); 
24 } 

2 } 

6 


这 段 代 码 和 上 文 里 的 ILoadBalancerDemo.java 很 相似 ， 但 有 如 下 的 差别 点 。 


(1) 在 第 5 行 里 ， 我 们 是 通过 BaseLoadBalancer 这 个 类 而 不 是 接口 来 定义 负载 均衡 器 ， 原 因 
是 该 类 包含 setRule 方法 。 
(2) 在 第 7 行 中 ， 定 义 了 一 个 基于 轮 询 规则 的 rule 对 象 ， 并 在 第 9 行 里 把 它 设置 进 负载 均衡 
器 。 
(3) 在 第 19 行 里 ， 我 们 是 把 包含 3 个 Server 的 List 对 象 放 入 负载 均衡 器 ， 而 不 是 之 前 的 两 
个 。 由 于 这 里 存 粹 是 为 了 演示 效果 ， 因 此 我 们 放 入 了 一 个 根本 不 存在 的 “ekserver3” 服 务 器 。 
运行 该 程序 后 ， 我 们 可 以 看 到 有 10 次 输出 ， 而 且 确 实 是 按 “ 轮 询 ” 的 规则 有 顺序 地 输出 3 个 
服务 器 的 名 字 。 如 果 我 们 把 第 7 行 改 成 如 下 代码 ， 就 会 看 到 “随机 ”地 输出 服务 器 名 。 


这 IRule rule = new RandomRule () 7 


4.3.3 1IPing: 判断 服务 器 是 否 可 用 的 接口 


在 项 目 里 ， 我 们 一 般 会 让 ILoadBalancer 接口 自动 地 判断 服务 器 是 否 可 用 (这 些 业务 都 封装 在 
Ribbon 的 底层 代码 里 ) 。 此 外 ， 我 们 还 可 以 用 Ribbon 组 件 里 的 IPing 接口 来 实现 这 个 功能 。 

在 下 面 的 IRuleDemo.java 代码 里 ， 我 们 将 演示 IPing 接口 的 一 般 用 法 。 同 样 ， 这 段 代码 也 是 在 
RibbonBasisDemo 这 个 项 目 里 。 


// 省 略 必 要 的 package 和 import 代码 
class MyPing implements IPing { 
Public boolean isRAlive(Server server) { 
// 如 果 服 务 器 名 是 ekserver2， 则 返回 false 
if (server.getHost() .equals ("ekserver2")) { 
return false; 
} 


return true; 


PoonGDNp 


on 


第 2 行 定义 的 MyPing 类 实现 了 IPing 接口 ， 并 在 第 3 行 重 写 了 其 中 的 isAlive 方法 。 
在 这 个 方法 里 ， 我 们 根据 服务 器 名 来 判断 。 有 具体 而 言 ， 如 果 名 字 是 ekserver2， 就 返回 false， 
表示 该 服务 器 不 可 用 ; 和 否则， 返回 tue， 表 示 当 前 服务 器 可 用 。 


11 public class IRuleDemo { 
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12 public static void main(String[] args) { 

13 BaseLoadBalancer loadBalancer = new BaseLoadBalancer (); 
14 // 定 义 IPing 类 型 的 myPing 对 象 

LS IPing myPing = new MyPing(); 

16 // 在 负载 均衡 器 里 使 用 myPing 对 象 

Hg loadBalancer.setPing (myPing) 7 

18 // 同 样 是 创建 三 个 Server 对象 并 放 入 负载 均衡 器 

19 List<Server> myServers = new ArrayList<Server>(); 
20 Server sl = new Server("ekserverl", 8080); 

兴旺 Server s2 = new Server("ekserver2", 8080); 

ef Server s3 = new Server ("ekserver3"，8080) 

本 本 myServers.add(s1) 

24 myServers.add(s2) 

25 myServers.add(s3); 

26 loadBalancer .addServers (myServers); 

27 // 通 过 for 循环 多 次 请 求 服务 器 

28 For (Lot dm OF dK LO T+r) 

29 Server s = loadBalancer.chooseServer (null); 
30 System.out.println(s.getHost() + ":" + s.getPort()); 
3 } 

32 } 

33 1 


在 第 12 行 的 main 函数 里 ， 我 们 在 第 15 行 创建 了 IPing 类 型 的 myPing 对 象 ， 并 在 第 17 行 把 
这 个 对 象 放 入 了 负载 均衡 器 。 通 过 第 18~26 行 的 代码 ， 我 们 创建 了 3 个 服务 器 ， 并 把 它们 也 放 入 
负载 均衡 器 。 

在 第 28 行 的 for 循 环 里 ,我 们 依然 是 请 求 并 输出 服务 器 名 。 由 于 这 里 的 负载 均衡 器 loadBalancer 
中 包含 了 一 个 IPing 类 型 的 对 象 ， 因 此 在 根据 策略 得 到 服务 器 后 ， 会 根据 myPing 里 的 isActive 方 
法 来 判断 该 服务 器 是 否 可 用 。 

由 于 在 这 个 方法 里 我 们 定义 了 ekServer2 这 台 服 务 器 不 可 用 ， 因 此 负载 均衡 器 loadBalancer 对 
象 始终 不 会 把 请 求 发 送 到 该 服务 器 上 ， 也 就 是 说 ， 在 输出 结果 中 ， 我 们 不 会 看 到 “ekserver2:8080” 
的 输出 。 

从 中 我 们 能 看 到 IPing 接口 的 一 般 用 法 ， 我 们 可 以 通过 重 写 其 中 的 isAlive 方法 来 定义 “判断 
服务 器 是 和 否 可 用 ”的 逻辑 。 在 实际 项 目 里 ， 判 断 的 依据 无 非 是 “服务 器 响应 是 否 时 间 过 长 ”或 “发 
往 该 服务 器 的 请 求 数 是 否 过 多 ”， 而 这 些 判断 方法 都 封装 在 IRule 接口 以 及 它 的 实现 类 里 ， 所 以 在 
一 般 的 场景 中 我 们 会 用 到 IPing 接口 。 


4.4 Ribbon 整合 Eureka 组 件 


在 上 文 里 ， 我 们 分 别 讲述 了 Ribbon 里 实现 负载 均衡 功能 的 相关 重要 组 件 ， 事 实 上 ，Ribbon 一 
般 不 会 单独 出 现 , 往往 是 嵌 在 其 他 架构 中 。 这 里 我 们 将 演示 Ribbon 和 Eureka 配套 使 用 的 开发 方式 。 
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4.4.1 整体 框架 的 说 明 


在 第 3 章 给 出 的 Eureka 的 高 可 用 案例 中 ， 我 们 就 已 经 用 到 了 LoadBalanced 注解 。 回 顾 一 下 如 
图 4.3 所 示 的 示意 图 ， 在 这 个 案例 中 ， 我 们 配置 了 两 台 相 互 注册 的 Eureka 服务 器 ， 但 服务 提供 者 
只 是 配置 在 一 台 机 器 上 ， 而 不 是 用 多 台 能 提供 服务 的 机 器 来 分 挫 流 量 。 


相互 注册 查找 服务 
Eureka 服 务 器 B 。 发 一 小 ”Eureka 服 务 器 A Eureka 客 户 端 
《包含 注册 中 心 ) 《包含 注册 中 心 ) 《服务 调用 者 》 


Eureka 客 户 端 
《服务 提供 者 


43 回顾 第 3 章 给 出 的 高 可 用 的 Eureka 框架 的 示意 图 


当时 我 们 引入 @LoadBalanced 注解 的 原因 是 , RestTemplate 类 型 的 对 象 本 身 不 具备 调用 远程 服 
务 的 能 力 ， 也 就 是 说 ， 引 入 该 注解 的 目的 存 粹 是 为 了 让 代码 跑 通 。 

在 本 案例 的 框架 里 , 我 们 将 配置 一 个 Eureka 服务 器 ， 搭 建 3 个 提供 相同 服务 的 Eureka 服务 提 
供 者 ， 同 时 在 Eureka 服务 调用 者 里 引入 Ribbon 组 件 。 这 样 ， 当 有 多 个 url 向 服务 调用 者 发 起 调用 
请 求 时 ， 整 个 框架 能 按 配 置 在 IRule 和 IPing 中 的 “负载 均衡 策略 ”和 “判断 服务 器 是 否 可 用 的 策 
略 ” 把 这 些 url 请 求 合理 地 分 摊 到 多 台 机 器 上 。 

从 图 4.4 中 ， 我 们 能 看 到 本 系统 的 结构 图 。 其 中 ，3 个 服务 提供 者 向 Eureka 服务 器 注册 服务 ， 
而 基于 Ribbon 的 负载 均衡 器 能 有 效 地 把 请 求 分 摊 到 不 同 的 服务 器 上 。 


Eureka 服 务 器 


注册 服务 注册 服务 
加 各 当代 服务 提供 者 2 | 服务 提供 | 
全 一 一 
页 要 区 而 
含有 Ribbon 的 
服务 调用 者 


图 4.4 Eureka 和 Ribbon 整合 后 的 结构 图 


为 了 让 大 家 更 方便 地 跑 通 这 个 案例 ， 我 们 将 讲解 全 部 的 服务 器 、 服 务 提 供 者 和 服务 调用 者 部 
分 的 代码 。 在 表 4.2 中 ， 列 出 了 本 架构 中 的 所 有 项 目 。 
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表 4.2 ”Ribbon 整合 Eureka 案例 中 的 项 目 列表 
项 目 名 说 明 
代码 \ 第 4 章 \EurekaRibbonDemo-Server Eureka 服务 器 
代码 \ 第 4 章 \EurekaRibbonDemo-ServiceProviderOne 
代码 \ 第 4 章 \EurekaRibbonDemo-ServiceProviderTwo 
代码 \ 第 4 章 \EurekaRibbonDemo-ServiceProviderThree 


在 这 3 个 项 目 里 , 分 别 部 署 
着 一 个 相同 的 服务 提供 者 


代码 \ 第 4 章 \EurekaRibbonDemo-ServiceCaller 服务 调用 者 
代码 位 置 视频 位 置 
| 见 表 42 视频 第 4 章 \Ribbon 和 Eureka 整合 的 案例 | 


4.4.2 ”编写 Eureka 服务 器 


这 部 分 的 代码 其 实 是 沿用 第 3 章 EurekaBasicDemo-Server 这 个 项 目的 ， 只 是 把 项 目 名 改 成 了 
EurekaRibbonDemo-Server。 在 本 书 附带 资料 的 相关 位 置 中 ， 大 家 能 看 到 完整 的 代码 。 

步骤 014 在 pom.xml 里 编写 本 项 目 需要 用 到 的 依赖 包 ， 其 中 通过 如 下 代码 引入 了 Eureka 服 
务 器 所 必需 的 包 。 


nL <dependencies> 

2 <dependency> 

3 <groupId>org.springframework.cloud</groupId> 

4 <artifactId>spring-cloud-starter-eureka-server</artifactId> 
5 </dependency> 


步 最 024 在 application.yml 这 个 文件 里 ， 指 定 了 针对 Eureka 服务 器 的 配置 ， 关 键 代 码 如 下 ， 


SerVer: 
Port: 8888 
eureka: 
instance: 
hostname: localhost 
client: 
serviceUrl: 
defaultZone: http://localhost:8888/eureka/ 


在 第 2 行 和 第 5 行 里 ， 指 定 了 本 服务 器 所 在 的 主机 地 址 和 端口 号 是 localhost:8888。 在 第 8 行 
里 ， 指 定 了 默认 的 url 是 http://localhost:8888/eureka/。 


步骤 03 在 RegisterCenterApp 这 个 服务 启动 程序 里 编写 启动 代码 。 
// 省 略 必要 的 package 和 import 代码 


@EnableEurekaServer 
@SpringBootApplication 

Public class RegisterCenterApp 
{ 


o vawmwwn 


Public static void main( String[] args ) 
下 


oamwm 必 wm 


SpringApplication.run (RegisterCenterApp.class, args); 
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10 } 


启动 该 程序 后 ， 能 在 http://localhost:8888/ 看 到 该 服务 器 的 相关 信息 。 


4.4.3 ”编写 Eureka 服务 提供 者 


这 里 有 3 个 服务 提供 者 ,它们 均 是 根据 第 3 章 里 的 EurekaBasicDemo-ServiceProvider 改写 而 来 。 


我 们 就 拿 EurekaRibbonDemo-ServiceProviderOne 来 举例 ， 看 一 下 其 中 包含 的 关键 要 素 。 


第 一 ， 同 样 是 在 pom.xml 里 ， 引 入 了 服务 提供 者 程序 所 需 的 jar 包 ， 不 过 在 其 中 需要 适当 地 修 


改 项 目 名 。 
第 二 ， 同 样 是 在 ServiceProviderAppjava 里 ， 编 写 了 启动 程序 ， 代 码 不 变 。 
第 三 ， 在 application.yml 里 ， 编 写 了 针对 这 个 服务 提供 者 的 配置 信息 。 关 键 代码 如 下 : 


server: 
Ports 111D 
spring: 
application: 
name: sayHello 
eureka: 
client: 
serviceUrl: 
defaultZone: http://localhost:8888/eureka/ 


在 第 2 行 里 ， 指 定 了 本 服务 是 运行 在 1111 端口 上 ， 在 另外 的 两 个 服务 提供 者 程序 里 ， 


Domo~wawmewNbP 


我 们 分 


别 指定 了 它们 的 工作 端口 是 2222 和 3333。 在 第 5 行 里 , 我 们 指定 了 服务 提供 者 的 名 字 是 sayHello， 
另外 两 个 服务 器 提供 者 的 名 字 同 样 是 sayHello， 正 因为 它们 的 名 字 都 一 样 ,所 以 服务 调用 者 在 请 求 


服务 时 ， 负 载 均衡 组 件 才能 有 效 地 分 排 流量 。 
第 四 ， 在 Controller 这 个 控制 器 类 里 ， 编 写 了 处 理 url 请 求 的 逻辑 。 关 键 代 码 如 下 : 


1 “// 省 略 了 必要 的 Package 和 import 的 代码 

2  @RestController 

3 public class Controller { 

4 @RequestMapping (value = "/sayHello/{username}", method = 
RequestMethod.GET) 


public String hello(@PathVariable ("username") String username) { 


System.out.println("This is ServerProvider1"); 


} 


5 
6 
return "Hello Ribbon, this is Serverl, my name is:" + username; 
8 
9 


在 第 2 行 里 ， 我 们 通过 @RestController 注解 来 说 明 本 类 承担 着 “控制 器 ”的 角色 。 在 第 4 行 
里 ， 我 们 定义 了 触发 hello 方法 的 url 格式 和 HTTP 请 求 的 方式 。 在 第 5~8 行 的 hello 方法 里 我 们 返 


回 了 一 个 字符 串 。 请 大 家 注意 , 在 第 6 行 和 第 7 行 的 代码 里 ,我 们 能 明显 地 看 出 输出 和 返回 


自 于 1 号 服务 提供 者 。 


EurekaRibbonDemo-ServiceProviderTwo 和 EurekaRibbonDemo-ServiceProviderOne 项 目 和 


改动 点 有 如 下 3 个 。 
第 一 ， 在 pom.xml 里 ， 把 项 目 名 修改 成 EurekaRibbonDemo-ServiceProviderTwo。 


信息 来 


民 相 似 ， 
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第 二 ， 在 application.yml 里 ， 把 端口 号 修改 成 2222。 关 键 代 码 如 下 : 

二 Server: 

2 Ports 2222 

第 三 ， 在 Controller.java 的 hello 方法 里 ， 在 输出 和 返回 信息 里 打上 “Server2” 的 标记 。 关 键 
代码 如 下 : 


下 @RequestMapping (value = "/sayHello/{username}", method = 
RequestMethod.GET ) 

2 Public String hello(@PathVariable("username") String username) { 

3 System.out.println("This is ServerProvider2"); 

4 return "Hello Ribbon, this is Server2, my name is:" + username; 

5 


} 
在 EurekaRibbonDemo-ServiceProviderThree 里 , 同样 在 EurekaRibbonDemo-ServiceProviderOne 
的 基础 上 做 上 述 3 个 改动 。 这 里 需要 在 application.yml 里 把 端口 号 修改 成 3333， 在 Controller 类 中 
需要 在 输出 和 返回 信息 中 打上 “Server3” 的 标记 。 大 家 可 以 到 本 书 附带 资料 的 相关 位 置 查看 本 项 
目的 全 部 代码 。 


4.4.4 在 Eureka 服务 调用 者 里 引入 Ribbon 


EurekaRibbonDemo-ServiceCaller 项 目 是 根据 第 3 章 的 EurekaBasicDemo-ServiceCaller 改写 而 
来 ， 其 中 的 关键 信息 如 下 。 


第 一 ， 在 pom.xml 里 ， 只 是 适当 地 修改 项 目 名 字 ， 没 有 修改 其 他 代码 。 
第 二 ， 没 有 修改 启动 类 ServiceCallerApp.java 里 的 代码 。 
第 三 ， 在 application.yml 里 ， 添 加 描述 服务 器 列表 的 listOfServers 属性 ， 代 码 如 下 : 


1 spring: 

4 application: 
3 name: callHello 
4 server: 

3 port: 8080 
6 eureka: 

7 client: 

8 serviceUrl: 

9 defaultZone: http://localhost:8888/eureka/ 

10 sayHello: 

3 ribbon: 

22 listOfServers: 

13 http://localhost:1111/,http://localhost:2222/,http://localhost:3333 


在 第 3 行 中 ， 我 们 指定 了 服务 调用 者 本 身 的 服务 名 是 callHello， 在 第 5 行 里 ， 指 定 了 这 个 微 
服务 器 运行 在 8080 端口 上 。 由 于 服务 调用 者 本 身 也 能 对 外 界 提供 服务 ， 因 此 外 部 程序 能 根据 这 个 
服务 名 和 端口 号 以 url 的 形式 调用 其 中 的 hello 方法 。 

这 里 的 关键 是 第 12~13 行 ， 我 们 通过 ribbon.listOfServers 指定 了 该 服务 调用 者 能 获得 服务 的 3 
个 url 地 址 。 注 意 ， 这 里 的 3 个 地 址 和 上 文 里 服务 提供 者 发 布 服务 的 3 个 地 址 是 一 致 的 。 

第 四 ， 在 控制 器 类 里 ， 用 RestTemplate 对 象 ， 以 负载 均衡 的 方式 调用 服务 ， 代 码 如 下 : 
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1  // 省 略 必要 的 package 和 import 的 代码 

2 @RestController 

3  Q@Configuration 

4 public class Controller { 

本 @Bean 

6 @LoadBalanced 

qi} Public RestTemplate getRestTemplate() 

8 { return new RestTemplate(); } 

> // 提 供 服务 的 hello 方法 

10 @RequestMapping (value = "/hello", method = RequestMethod.GET ) 

条 public String hello() { 

be RestTemplate template = getRestTemplate(); 

3 String retVal = template.getForEntity( 
"http://sayHello/sayHello/Eureka", String.class) .getBody(); 

14 return "In Caller, " + retVal; 

15 } 

16 } 


在 这 个 控制 器 类 的 第 7 行 里 ,我 们 通过 getRestTemplate 方法 返回 一 个 RestTemplate 类 型 对 象 。 
RestTemplate 是 Spring 提供 的 能 以 Rest 形式 访问 服务 的 对 象 ， 本 身 不 具备 负载 均衡 的 能 力 ， 所 以 
我 们 需要 在 第 6 行 通过 @LoadBalanced 注解 赋予 它 这 个 能 力 。 

在 第 11~15 行 的 hello 方法 里 ， 我 们 首先 在 第 12 行 通过 getRestTemplate 方法 得 到 了 template 
对 象 ， 随 后 通过 第 13 行 的 代码 用 template 对 象 提供 的 getForEntity 方法 访问 之 前 Eureka 服务 提供 
者 提供 的 “http://sayHello/sayHello/Eureka ”服务 ， 并 得 到 String 类 型 的 结果 ， 最 后 在 第 14 行 根据 
调用 结果 返回 一 个 字符 串 。 由 于 在 框架 里 我 们 模拟 了 在 3 台 机 器 上 部 署 服务 的 场景 , 而 在 上 述 服 务 
调用 者 的 代码 里 我 们 又 在 template 对 象 上 加 入 了 @LoadBalanced 注解 ， 因 此 在 第 13 行 代 码 里 发 起 
的 请 求 会 被 均 挫 到 3 台 服 务 器 上 。 

需要 注意 的 是 , 这 里 我 们 没有 重 写 IRule 和 IPing 接口 ,所 以 这 里 采用 的 是 默认 的 RoundRobbin 

(也 就 是 轮 询 ) 的 访问 策略 ， 同 时 将 默认 所 有 的 服务 器 都 处 于 可 用 状态 。 

依次 启动 本 框架 中 的 Eureka 服务 器 、3 台 服 务 提 供 者 和 服务 器 调用 者 的 服务 之 后 ， 在 浏览 器 
里 输入 “http://localhost:8888/”， 我 们 能 看 到 如 图 4.5 所 示 的 效果 。 其 中 ， 有 3 个 提供 服务 的 
SAYHELLO 应 用 实例 , 它们 分 别 运行 在 1111、2222 和 3333 端口 上 , 同时 服务 调用 者 CALLHELLO 
运行 在 8080 端口 上 。 


System Status 


2018-03-16T07:05:10 *080 


DS Replicas 


Instances currently registered with Eureka 


Application 


CALLHELLO 1 UP 人- 192.168 .42 Lcal 


ja 回 - 
seuo WM? 日 ry 


) 192168 
图 4.5 启动 所 有 服务 后 在 控制 台中 的 效果 图 
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如 果 我 们 不 断 在 浏览 器 里 输入 “http://localhost:8080/hello”， 就 能 依次 看 到 如 下 所 示 的 输出 。 


In 
In 
In 
In 
In 
In 


amwmtewnP 


Caller, 
Caller, 
Caller, 
Caller, 
Caller, 
Caller, 


从 上 述 输出 来 看 ， 


的 次 序 ， 但 每 次 都 能 看 到 “负载 均衡 ”的 效果 。 


Hello 
Hello 
Hello 
Hello 
Hello 
Hello 


Ribbon, 
Ribbon, 
Ribbon, 
Ribbon, 
Ribbon, 
Ribbon, 


this i 
this i 
this i 
this i 
this 1 
this i 


请 求 是 以 Server2、Serverl 


4.4.5” 重 写 IRule 和 |Ping 接口 


Server2, my 
Serverl, my 
Server3, my 
Server2, my 
Serverl, my 
Server3, my 


name 


name 
name 
name 
name 


name 


:Eureka 
:Eureka 
:Eureka 
:Eureka 
:Eureka 
:Eureka 


和 Server3 的 次 序 被 均 摊 到 3 台 服 务 器 上 。 在 每 
次 启动 服务 后 ,可 能 承接 请 求 的 服务 器 次 序 会 有 所 变化 ,可 能 下 次 是 按 Serverl1、Server2 和 Server3 


这 里 ， 我 们 将 在 上 述 案 例 的 基础 上 重 写 IRule 和 IPing 接口 里 的 方法 ， 从 而 实现 自 定义 负载 均 
衡 和 判断 服务 器 是 否 可 用 的 规则 。 


由 于 我 们 是 在 客户 端 ， 也 就 是 EurekaRibbonDemo-ServiceCaller 这 个 项 目 调用 服务 ， 因 此 
本 部 分 的 所 有 代码 都 是 写 在 这 个 项 目 里 的 。 


步骤 014 编写 包含 负载 均衡 规则 的 MyRulejava， 代 码 如 下 : 


16 } 


在 上 述 代 码 的 第 3 行 里 ， 我 们 实现 了 IRule 类 ， 并 在 其 中 的 第 6 行 里 


Private ILoadBalancer lb; 
// 必 须要 重 写 这 个 choose 方法 
public Server choose (Object key) { 

// 得 到 0 到 3 的 一 个 随机 数 ， 但 不 包括 3 


int number 


= (int) (Math.random() * 3); 


package com.controller; // 请 注意 这 个 Package 路 径 
// 省 略 必 要 的 import 语句 
Public class MyRule implements IRule {// 实 现 IRule 类 


System.out .Println("Choose the number is:" + number) 


// 得 到 所 有 的 服务 器 对 象 


List<Server> servers = lb.getAllServers(); 


// 根 据 随 机 数 返 回 一 个 服务 器 


return servers.get (number); 


} 
// 省 略 必要 的 get 和 set 方法 


和 E 写 了 choose 方法 。 在 


这 个 方法 里 ， 我 们 在 第 8 行 通过 Math.random 方法 得 到 了 0 到 3 之 间 的 一 个 随机 数 ， 包 括 0， 但 不 


包括 3， 并 用 这 个 随机 数 在 第 13 行 返 


回 了 一 个 Server 对 象 ， 以 此 实现 随机 选择 的 效果 。 在 实际 的 


项 目 里 ， 还 可 以 根据 具体 的 业务 逻辑 choose 方法 来 实现 其 他 “选择 服务 器 ”的 策略 。 
的 MyPingjava， 代 码 如 下 : 


步 蛇 024 编写 判断 服务 器 是 否 可 上 
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1 package com.controller; // 也 请 注意 这 个 package 的 路 径 

2  // 省 略 import 语句 

3 public class MyPing implements IPing { // 这 里 是 实现 IPing 类 

4 // 重 写 了 判断 服务 器 是 否 可 用 的 isAlive 方 法 

号 public boolean isRlive(Server server) { 

6 // 这 里 是 生成 一 个 随机 数 ， 以 此 来 判断 该 服务 器 是 否 可 用 

7 // 还 可 以 根据 服务 器 的 响应 时 间 等 依据 判断 服务 器 是 否 可 用 

8 double data = Math.random(); 

9 if (data > 0.6) { 

10 System.out.println("Current Server is available, Name: " + 
server.getHost() + ", Port is:" + server.getHostPort()); 

下 return true; 

be } else { 

be System.out.println("Current Server is not available, Name: " 
+ server.getHost() + ", Port is:" + server.getHostPort ()); 

14 return false; 

Ee 4 

16 } 

六 了 小 


在 第 3 行 里 ， 我 们 是 实现 了 IPing 接口 ， 并 在 第 5 行 重 写 了 其 中 的 isAlive 方法 。 
在 这 个 方法 里 ， 我 们 根据 一 个 随机 数 来 判断 该 服务 器 是 否 可 用 ， 如 果 可 用 ， 就 返回 true， 反 之 
则 返回 false。 注 意 ， 这 仅仅 是 一 个 演示 的 案例 ， 在 实际 项 目 里 ， 我 们 基本 上 是 不 会 重 写 isAlive 方 
法 的 。 
步骤 03Q 改写 application.yml， 在 其 中 添加 关于 MyPing 和 MyRule 的 配置 ， 代 码 如 下 : 


spring: 
application: 
name: callHello 
server: 
port: 8080 
eureka: 
client: 
serviceUrl: 
9 defaultZone: http://localhost:8888/eureka/ 
10 sayHello: 
5 ribbon: 


o vawmw 必 wm 


12 NFLoadBalancerRuleClassName: com.controller.MyRule 
13 NFLoadBalancerPingClassName: com.controller.MyPing 
14 listOfServers: 


15 http://localhost:1111/,http://localhost:2222/,http://localhost:3333 


改动 点 是 第 10~13 行 ， 注 意 这 里 的 SayHello 需要 和 服务 提供 者 给 出 的 “服务 名 ”一 致 。 在 第 
12 行 、 第 13 行 里 ， 分 别 定 义 了 本 程序 (也 就 是 服务 调用 者 ) 所 用 到 的 MyRule 和 MyPing 类 ， 配 
置 时 需要 包含 包 名 和 文件 名 。 


步骤 044 改写 Controllerjava 和 这 个 控制 器 类 ， 代 码 如 下 。 


// 省 略 必 要 的 package 和 import 代码 
@RestController 

@Configuration 

Public class Controller { 


心 w IN 上 


Se 一 


5 // 以 Autowired 的 方式 引入 loadBalancerClient 对 象 
6 @Autowired 

7 Private LoadBalancerClient loadBalancerClient; 
8 // 给 RestTemplate 对 象 加 入 eLoadBalanced 注解 


9 // 以 此 赋予 该 对 象 负载 均衡 的 能 力 

10 @Bean 

于 @LoadBalanced 

2 Public RestTemplate getRestTemplate() 

3 { return new RestTemplate(); } 

14 QBean // 引 入 MyRule 

5 public IRule ribbonRule() 

16 { return new MyRule();} 

17 @Bean // 引 入 MyPing 

18 Public IPing ribbonpIng() 

19 { return new MyPing();} 

20 // 编 写 提供 服务 的 hello 方法 

2 @RequestMapping (value = "/hello", method = RequestMethod.GET ) 

2 Public String hello() { 

23 // 引 入 策略 ， 这 里 的 sayHel1lo 需要 和 application.yml 

24 // 第 10 行 的 sayHello 一 致 ， 这 样 才能 引入 MyPing 和 MyRule 

25 loadBalancerClient .choose("sayHello") 7; 

26 RestTemplate template = getRestTemplate(); 

27 String retVal = template.getForEntity( 
"http://sayHello/sayHello/Eureka", String.class) .getBody(); 

28 return "In Caller, " + retVal; 

29 } 

30% 


和 之 前 的 代码 相 比 ， 我 们 添加 了 第 15 行 和 第 18 行 的 两 个 方法 ， 以 此 引入 自 定义 的 MyRule 
和 MyPing 两 个 方法 。 

而 且 ， 在 hello 方法 的 第 15 行 里 ， 我 们 通过 choose 方法 为 loadBalancerClient 这 个 负载 均衡 对 
象 选择 了 MyRule 和 MyPing 这 两 个 规则 。 

如 果 依 次 启动 Eureka 服务 器 ,注册 在 Eureka 里 的 3 个 服务 提供 者 和 服务 调用 者 之 后 , 在 浏览 
器 里 输入 “http:Wlocalhost:8080/hello”， 就 能 在 EurekaRibbonDemo-ServiceCaller 的 控制 台 里 看 到 
类 似 于 如 下 的 输出 。 

1 Choose the number is:1 

2 Choose the number is:0 

3 Current Server is not available, Name: 192.168.42.1, 

Port T8921680 A212 
4 Current Server is available, Name: 192.168.42.1, Port is:192.168.42.1:3333 


5 Current Server is not available, Name: 192.168.42.1, 
Port 19:192.168842- L211 


第 1 行 和 第 2 行 是 MyRule 里 的 输出 , 第 3~5 行 是 MyPing 里 的 输出 ， 由 于 这 些 输 出 和 随机 数 
有 关 ， 因 此 每 次 输出 的 内 容 未 必 一 致 ， 但 至 少 能 说 明 我 们 在 MyRule 和 MyPing 里 配置 的 相关 策略 
是 生效 的 ， 服 务 调用 者 (EurekaRibbonDemo-ServiceCaller) 的 多 次 请 求 在 以 “负载 均衡 ”的 方式 分 
发 到 各 服务 提供 者 时 会 引入 我 们 定义 在 上 述 两 个 类 里 的 策略 。 
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4.4.6 ”实现 双 服 务 器 多 服务 提供 者 的 高 可 用 效果 


代码 位 置 视频 位 置 
代码 \ 第 4 章 \RabbionBasicDemo 视频 \ 第 4 章 \ 负 载 均衡 高 可 用 案例 


这 里 我 们 把 相同 的 服务 提供 模块 部 署 在 3 台 服 务 器 上 ， 除 了 能 得 到 “负载 均衡 ”的 便利 之 外 ， 
还 达到 了 “高 可 用 ”的 效果 , 比如 3 台 服 务 器 中 的 某 台 失效 了 , 系统 就 会 把 请 求 发 送 到 其 他 机 器 上 。 

这 种 “高 可 用 ”的 特性 是 互联 网 项 目 〈 尤 其 是 高 并 发 互联 网 项 目 ) 的 必 备 需求 ， 不 过 这 里 依 
然 有 一 个 隐患 : 如果 Eureka 服务 器 失效 了 ， 那 么 即使 3 台 提 供 服 务 的 机 器 都 可 用 ， 服 务 调 用 者 也 
还 是 无 法 得 到 服务 。 

在 第 3 章 里 ， 我 们 配置 了 两 个 相互 注册 的 Eureka 服务 器 ， 这 里 我 们 将 在 当前 “多 服务 提供 者 ” 
的 基础 上 引入 “ 双 Eureka 服务 器 ”的 效果 ， 以 此 实现 更 高 程度 的 “高 可 用 ”效果 。 整 个 系统 的 架 
构 如 图 4.6 所 示 。 


Eureka 服 务 器 


人 相互 注册 


Eureka 服 务 器 


注册 服务 注册 服务 


有 人 服务 提供 者 2 慑 交代 


和 


负载 均衡 器 


人 


含有 Ribbon 的 
服务 调用 者 


图 4.6 双 服务 器 多 服务 提供 者 的 高 可 用 架构 示意 图 


从 图 4.6 中 我 们 能 看 到 ， 只 有 当 两 台 Eureka 服务 器 都 宕 机 ,或 者 所 有 提供 服务 的 机 器 都 宕 机 ， 
整个 系统 才 无 法 对 外 提供 服务 , 但 事实 上 发 生 这 些 情 况 的 概率 非常 低 。 更 何况 在 真实 项 目 里 我 们 会 
时 刻 监 听 每 台 服 务 器 的 状态 ， 只 要 发 生 不 可 用 ， 就 会 立即 发 送 邮件 等 推送 信息 ， 这 样 维护 人 员 就 能 
立即 介入 修复 。 

为 了 实现 上 述 效果 ， 我 们 需要 在 4.4.5 小 节 代码 的 基础 上 做 如 下 修改 。 


步骤 01 4 在 EurekaRibbonDemo-Server 项 目 里 ， 修 改 application.yml， 代 码 如 下 : 


. spring: 
2 application: 
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name: ekServerl 
server: 
port: 8888 
eureka: 
instance: 
hostname: ekServerl 
client: 
ServiceUrl: 
defaultZone: http://ekServer2:8889/eureka/ 


PPieoowaoumww 


0 
这 里 同样 需要 在 hosts 文件 里 添加 ekServerl 和 ekServer2， 具 体 做 法 请 参照 3.3 节 的 说 明 。 请 
注意 在 第 11 行 里 ， 本 服务 器 是 向 另外 一 台 ekServer2:8889 注册 。 


步 又 024 创建 名 为 EurekaRibbonDemo-backup-Server 的 项 目 ， 代 码 和 EurekaRibbonDemo- 
Server 大 多 一 致 ， 但 需要 修改 其 中 的 application.yml， 代 码 如 下 : 


汪 spring: 

2 application: 

3 name: ekServer2 

4 server: 

5 port: 8889 

6 eureka: 

生 instance: 

8 hostname: ekServer2 
9 client: 

10 serviceUrl: 

hl defaultZone: http://ekServer1:8888/eureka/ 


这 个 ekServerl 里 的 配置 是 对 偶 的 ， 在 第 11 行 里 ， 指 定 本 服务 是 向 ekServerl 的 8888 端口 注 

册 。 结合 刚才 ekServerl 的 配置 , 我 们 能 看 到 这 两 台 服务 器 (ekServerl 和 ekServe2) 是 相互 注册 的 ， 

以 此 实现 “ 热 备 元 余 ”的 效果 。 

步骤 034 在 3 个 服务 提供 者 和 一 个 服务 调用 者 的 项 目 里 ， 修 改 它 们 的 application.yml， 其 中 
需要 修改 的 部 分 如 下 : 


1 eureka: 

2 client: 

3 serviceUrl: 

4 #defaultZone: http://localhost:8888/eureka/ 
5 defaultZone: http://ekServerl:8888/eureka/ 


原来 采用 第 4 行 的 代码 是 向 localhost:8888 注册 ， 现 在 是 向 ekServer1:8888 注册 。 

修改 完成 后 ， 先 启动 两 个 包含 Eureka 服务 器 的 程序 ， 再 启动 3 个 包含 服务 提供 者 的 程序 ， 最 
后 启动 服务 调用 者 的 程序 。 启 动 完成 后 ， 我 们 可 以 通过 http://ekserver1:8080/hello 来 查看 调用 hello 
服务 的 效果 ， 这 里 的 效果 和 4.4.5 小 节 中 运行 的 效果 一 致 ， 所 以 就 不 再 额外 给 出 了 。 

同样 ， 如 果 我 们 故意 停止 一 个 包含 Eureka 服务 器 的 程序 (比如 EurekaRibbonDemo-Server 程 
序 ) ， 以 此 来 模拟 一 台 服 务 器 失效 的 效果 ， 由 于 这 里 实现 了 双 服 务 器 相互 注册 ,所 以 如 果 再 次 在 浏 
览 器 里 输入 “http://ekserver1:8080/hello”， 那 么 依然 可 以 看 到 调用 服务 后 的 输出 效果 。 
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4.5 配置 Ribbon 的 常用 参数 


在 上 文 里 ， 我 们 是 在 application.yml 里 配置 Ribbon 诸如 负载 均衡 策略 等 信息 ， 在 这 部 分 里 我 
们 将 归纳 其 他 常用 参数 。 


代码 位 置 视频 位 置 | 
代码 \ 第 4 章 \RabbionBasicDemo 视频 \ 第 4 章 \ 常 用 的 Ribbon 参数 


4.5.1 参数 的 影响 范围 


在 EurekaRibbonDemo-ServiceCaller 项 目的 application.yml 里 ， 我 们 采用 sayHello.ribbon 的 形 
式 配置 参数 ， 格 式 如 下 : 


二 sayHello: 


2 ribbon: 

3 NFLoadBalancerRuleClassName: com.controller.MyRule 

上 述 格式 的 参数 是 针对 sayHello 服务 的 。 此 外 ， 我 们 还 可 以 如 下 形式 配置 全 局 性 的 参数 : 
ribbon: 

2 NFLoadBalancerRuleClassName: com.controller.MyRule 


这 里 参数 的 作用 范围 是 全 局 , 也 就 是 说 , 在 MyRule 中 定义 的 负载 均衡 规则 将 作用 在 所 有 的 服 
务 上 ， 而 不 仅仅 是 sayHello 这 个 服务 上 。 


4.5.2 ”归纳 常用 的 参数 


在 EurekaRibbonDemo-ServiceCaller 项 目的 application.yml 里 ， 我 们 通过 如 下 代码 配置 了 Rule 
规则 、Ping 规则 和 可 用 服务 器 的 列表 ， 其 中 第 1 行 的 sayHello 是 服务 名 ， 说 明 这 些 配置 不 是 全 局 
性 的 ， 而 是 仅仅 针对 sayHello 这 个 服务 。 

1 sayHello: 

和 ribbon: 

3 NFLoadBalancerRuleClassName: com.controller.MyRule 

4 NFLoadBalancerPingClassName: com.controller.MyPing 

区 listOfServers: http://localhost:1111/,http://localhost:2222/, 

http://localhost:3333 


这 里 我 们 再 给 出 一 些 其 他 的 常用 配置 ， 具体 的 含义 请 看 注释 。 


1， sayHello: 

2 ribbon: 

3 ConnectionTimeout: 200 # 连 接 的 超时 时 间 

4 RealTimeout: 1000 # 连 接 外 带 处 理 的 超时 时 间 

号 MaxAutoRetries: 5 # 对 当前 请 求实 例 的 重 试 次 数 

6 MaxHttpConnectionsPerHost:5 }# 对 每 个 主机 每 次 最 多 的 HTTP 请 求 数 
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了 EnableConnectionPool:true # 是 否 启用 连接 池 来 管理 连接 
8 # 只 有 第 7 行 的 值 是 true， 如 下 相关 池 的 属性 才能 生效 

9 PoolMaxThreads:10 # 池 中 最 大 线程 数 

10 PoolMinThreads: 2 # 池 中 最 小 线程 数 

a PoolKeepAliveTime: 10 ”# 线 程 的 等 待 时 间 

2 PoolKeepAliveTimeUnits:SECONDS # 等 待 时 间 的 范围 


4.5.3 在 类 里 设置 Ribbon 参数 


除了 能 在 application.yml 里 设置 外 ， 我 们 还 可 以 在 Java 类 里 编写 针对 Ribbon 的 配置 参数 。 这 
里 我 们 在 EurekaRibbonDemo-ServiceCaller 的 基础 上 ， 重 新 编写 一 个 服务 调用 者 项 目 ， 命 名 为 
EurekaRibbonConfigDemo-ServiceCaller， 在 其 中 演示 通过 类 设置 Ribbon 参数 的 做 法 。 

这 个 项 目 和 EurekaRibbonDemo-ServiceCaller 非常 相似 ， 但 有 如 下 差别 。 


差别 1， 在 application.yml 里 ， 去 掉 针 对 IRule 和 IPing 实现 类 的 配置 ， 关 键 代 码 如 下 ， 其 中 我 
们 能 看 到 注释 掉 了 第 3 行 和 第 4 行 的 代码 。 


sayHello: 
ribbon: 
# NFLoadBalancerRuleClassName: com.controller.MyRule 
# NFLoadBalancerPingClassName: com.controller.MyPing 
listOfServers: http://localhost:1111/, 
http://localhost:2222/, http://localhost:3333 


ManwD 


差别 2， 新 建 ConfigRibbon.java， 在 其 中 引入 MyRule 和 MyPing 类 ， 代 码 如 下 。 
省 略 必 要 的 package 和 import 代码 


@Configuration 

Public class ConfigRibbon{ 
@Bean 
public IRule getRule() 
{ return new MyRule(); } 
Q@Bean 
Public IPing getPing() 
{ return new MyPing();} 


PoowauwmwwNP 


0 } 


在 第 2 行 里 , 我 们 通过 @Configuration 这 个 注解 说 明 本 类 是 配置 类 。 在 第 5 行 和 第 8 行 里 , 我 
们 提供 了 getRule 和 getPing 这 两 个 方法 ， 由 于 它们 被 @Bean 这 个 注解 修饰 ， 因 此 能 被 Spring 容器 
自动 注入 。 

差别 3， 改 写 Controller 部 分 的 代码 。 


省 略 必 要 的 package 和 import 代码 
@RestController 
@Configuration 
Public class Controller { 
// 提 供 被 LoadBalanced 修饰 的 RestTemplate 对 象 
@Bean 
@LoadBalanced 
Public RestTemplate getRestTemplate() 
{ return new RestTemplate() 7 } 


oAMAONp 
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10 // 在 hello 方法 里 ， 无 需 再 从 配置 文件 里 获得 参数 


1 @RequestMapping (value = "/hello", method = RequestMethod.GET ) 

12 public String hello() { 

3 RestTemplate template = getRestTemplate(); 

14 String retVal = template.getForEntity( 
"http://sayHello/sayHello/Eureka", String.class) .getBody(); 

15 return "In Caller, " + retVal; 

16 } 

kh 


由 于 我 们 在 ConfigRibbon 类 里 已 经 把 MyRule 和 MyPing 通过 @Bean 注解 放 入 了 容器 ， 同 时 
hello 方法 里 的 RestTemplate 对 象 又 被 @LoadBalanced 注解 修饰 ， 因 此 通过 RestTemplate 实现 负载 
均衡 时 ， 会 自动 地 调用 封装 在 MyRule 和 MyPing 里 的 方法 。 

在 ConfigRibbon 类 里 定义 的 Ribbon 配置 是 全 局 性 的 。 此 外 ， 我 们 还 可 以 通过 @RibbonClinet 
注解 让 配置 参数 只 作用 在 单个 服务 上 , 具体 的 做 法 是 新 建 一 个 名 为 ConfigRibbonSayHello 的 类 , 代 
码 如 下 : 

1 ”省 略 必要 的 package 和 import 代码 

@Configuration 

总 @RibbonClient (name="sayHello", configuration=ConfigRibbon.class) 

4 Public class ConfigRibbonSayHello { } 

其 中 ， 在 类 里 可 以 不 用 放任 何 代 码 ， 但 需要 用 类 似 第 3 行 的 注解 来 修饰 这 个 类 。 

在 定义 @RibbonClient 注解 时 ， 需 要 用 configuration 来 指定 包含 配置 信息 的 类 名 , 需要 用 name 
来 指定 这 个 配置 所 作用 的 服务 名 。 

改写 完成 后 ， 我 们 可 以 依次 启动 Eureka 服务 器 、3 个 服务 提供 者 和 基于 配置 文件 的 服务 调用 
者 ， 随 后 在 浏览 器 里 输入 “http://localhost:8080/hello”， 同 样 能 在 控制 台 里 看 到 定义 在 MyRule 和 
MyPing 里 的 输出 ， 这 说 明基 于 类 的 配置 参数 成 功 生效 。 


4.6 本 章 小 结 


在 本 章 里 ， 我 们 首先 介绍 了 目前 比较 常见 的 基于 软件 和 硬件 实现 负载 均衡 的 解决 方案 ， 并 在 
此 基础 上 介绍 了 Spring Cloud 全 家 桶 里 实现 负载 均衡 的 重要 组 件 : Ribbon。 随 后 ， 我 们 在 代码 层面 
介绍 了 Ribbon 各 重要 组 件 的 用 法 ， 以 及 在 Eureka 框架 里 整合 Eureka 的 各 种 做 法 。 最 后 ， 我 们 还 
讲述 了 通过 配置 文件 和 配置 类 在 Eureka 框架 里 引入 Ribbon 参数 的 常见 开发 方式 。 


第 口 章 


服务 容错 组 件 : HyStrix 


Hystrix 组 件 就 像 日 常生 活 中 的 保险 丝 一 样 ,能 对 高 并 发 的 Web 应 用 系统 起 到 熔断 保护 的 作用 。 
如 果 没 有 保险 丝 , 当 过 载 的 电流 到 达 时 , 就 会 导致 电器 损害 等 严重 后 果 , 如 果 没 有 配置 基于 Hystrix 
的 保护 机 制 ， 过 载 的 流量 同样 会 瘫痪 整 个 Web 应 用 ， 这 会 导致 客户 流失 等 严重 后 果 。 

Hystrix 不 仅仅 是 单纯 的 组 件 ， 其 中 还 包含 了 Netflix 开发 团队 对 分 布 式 系统 尤其 是 高 并 发 分 
布 式 系 统 ) 容错 保护 的 各 种 实践 的 总 结 。 在 本 章 里 ， 我 们 不 会 只 讲 Hystrix 的 常见 用 法 ， 会 讲述 如 
何 用 Hystrix 组 件 为 系统 配置 保险 丝 ， 从 而 避免 系统 骨 溃 的 常见 实践 方案 。 


5.1 在 微服 务 系统 里 引入 Hystrix 的 必要 性 


任何 一 个 网 站 都 有 可 能 出 故障 ， 故 障 的 发 生 率 只 是 概率 问题 ， 一 旦 出 现 故 障 ， 导 致 的 后 果 就 
可 能 足以 导致 网 站 倒闭 ,下 面 我 们 通过 一 道 不 复杂 的 概率 算术 题 来 看 一 下 看 似 健壮 的 系统 出 故障 的 


5.1.1 通过 一 些 算术 题 了 解 系统 发 生 错误 的 概率 


我 们 一 般 用 每 秒 查询 率 〈Query Per Second，QPS) 来 衡量 一 个 网 站 的 流量 。QPS 是 指 一 台 服 
务 器 在 一 秒 里 能 处 理 的 查询 次 数 ， 可 以 被 用 来 衡量 服务 器 的 性 能 。 

假设 一 个 Web 应 用 有 20 个 基于 微服 务 的 子 模块 ， 比 如 某 电 商 系统 里 有 订单 、 合 同 管理 和 会 员 
管理 等 子 模块 ， 该 系统 的 平均 QPS 是 1000， 也 就 是 说 平均 每 秒 有 1000 个 访问 量 ， 这 个 数值 属于 
中 等 水 平 ， 并 不 高 。 

算术 题 一 ， 请 计算 每 天 的 访问 总 量 。 注 : 一 般 网 站 在 凌晨 1 点 到 上 午 9 点 的 访问 量 比较 少 ， 
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所 以 计算 时 按 每 天 16 小 时 计算 。 

答 : 1000*60*60*16=57600000=5.76 乘 以 10 的 8 次 方 。 

算术 题 二 : 由 于 该 系统 中 有 20 个 子 模块 ,在 处 理 每 次 请 求 时 ， 该 模块 有 99.9999% 的 概率 不 出 
错 〈 百 万 分 之 一 的 出 错 概率 ， 这 个 概率 很 低 了 ) ， 任 何 一 个 模块 出 错 ， 整 个 系统 就 出 错 ， 那 么 每 小 
时 该 系统 出 错 的 概率 是 多 少 ? 每 天 〈 按 16 小 时 算 ) 是 多 少 ? 每 月 〈 按 30 天 算 ) 又 是 多 少 ? 

答 : 针对 每 次 访问 ， 一 个 模块 正常 工作 的 概率 是 99.9999%， 那 么 每 小 时 20 个 模块 都 不 出 错 的 
概率 是 99.9999% 的 〈20*3600) 次 方 ， 大 约 是 93%。 换 名 话说， 在 一 个 小 时 内 ， 该 系统 出 错 的 概率 
是 7%。 

我 们 再 来 算 每 天 的 正常 工作 概率 ， 是 93% 的 16 次 方 ， 大 约 是 31%。 换 名 话说， 每 天 出 错 的 概 
率 高 达 69%。 同 理 ， 我 们 能 算出 ， 每 月 出 错 的 概率 高 达 95%。 

通过 这 组 数据 ， 我 们 能 看 到 ， 规 模 尚 属 中 等 的 网 站 〈 相 当 于 尚 能 正常 盘 利 不 亏本 的 网 站 ) 平 
均 每 月 就 会 出 现 一 次 故障 ， 对 于 那些 模块 故障 率 高 于 百 万 分 之 一 或 平均 QPS 更 高 的 网 站 ， 这 个 出 
故障 周期 会 更 频繁 。 所以， 对 于 互联 网 公司 而 言 ， 服 务 容错 组 件 是 必 配 ， 而 不 是 优化 项 。 


5.1.2 ”用 通俗 方式 总 结 Hystrix 的 保护 措施 


对 于 互联 网 公司 而 言 ， 与 其 自己 开发 一 套 容 错 组 件 ， 还 不 如 用 现成 的 ， 因 为 对 公司 而 言 ， 应 
该 把 精力 用 到 能 直接 产生 价值 的 业务 开发 上 。 

在 Spring Cloud 微服 务 架 构 体 系 中 ，Hystrix 是 一 个 现成 的 解决 方案 ， 归 纳 起 来 讲 ，Hystrix 能 
提供 熔断 、 隔 离 〈 包 括 线程 隔离 和 信号 量 隔 离 》 和 请 求 合并 等 容错 保护 措施 。 

当 系 统 中 某 个 模块 故障 率 过 高 时 ，Hystrix 会 自动 开启 熔断 模式 ， 针 对 后 续 的 请 求 直接 提供 出 
错 提示 页 面 。 就 好 比 某 个 办 事 部 门 无 法 继续 提供 服务 时 , 不 是 一 声 不 咏 任 由 等 待 服务 的 人 群 继续 排 
队 ， 而 是 或 者 贴 出 一 张 通知 告示 (就 好 比 跳 转 到 出 错 提示 页 面 )， 或 者 由 其 他 部 门 接手 服务 (启动 
热 备 元 余 服务 ) 。 

Hystrix 的 隔离 机 制 就 好 比 在 船 里 的 水 密 仓 ， 当 某 处 进 水 时 (发 生 系统 调用 故障 时 ) ， 最 多 只 
会 影响 少量 的 水 密 仓 ,不 至 于 整 船 淹没 (整个 系统 崩溃 ) ， 这 样 一 来 能 缩小 故障 规模 ， 不 至 于 发 生 
故障 蔓延 式 的 雪崩 ， 还 能 大 大 降低 故障 修复 的 难度 。 

在 Web 应 用 场景 里 , 用 户 每 触发 一 个 URL 请 求 ， 都 会 由 一 个 为 此 新 建 的 线程 来 处 理 ， 在 高 并 
发 的 场景 下 ， 这 会 导致 服务 器 负载 过 重 ， 事 实 上 ， 同 类 的 URL 做 的 事情 其 实 是 相同 的 ， 比 如 查询 
分 页 的 不 同 请 求 里 ， 唯 一 的 差别 是 请 求 参 数 〈 比 如 页 数 ) 不 同 。 

Hystrix 为 此 提供 了 合并 请 求 的 功能 , 即 能 把 在 某 个 时 间 段 内 相同 类 型 的 请 求 合并 到 一 起 处 理 ， 
这 样 能 很 大 程度 上 降低 Web 服务 器 的 负载 。 

Hystrix 除了 能 提供 上 述 各 种 保护 措施 外 ， 还 实时 监控 网 络 流量 ， 当 出 现 异 常 时 ， 能 根据 设置 
自动 报警 ， 让 运营 等 人 员 在 第 一 时 间 介入 并 排除 故障 。 


74 | Spring Cloud 实战 


5.2 ”通过 案例 了 解 Hystrix 的 各 种 使 用 方式 


在 这 部 分 里 ， 我 们 将 演示 Hystrix 的 各 种 工作 流程 ， 具 体 包 括 通过 Ribbon 调用 正常 的 和 不 可 
用 的 服务 ， 此 外 还 将 讲述 在 Hystrix 引入 缓存 和 设置 Hystrix 的 各 种 配置 的 方法 。 


5.2.1 准备 服务 提供 者 


这 里 我 们 将 在 HystrixServerDemo 项 目 里 提供 两 个 供 Hystrix 调用 的 服务 ， 其 中 一 个 是 可 用 的 ， 
而 在 另外 一 个 服务 里 是 通过 sleep 机 制 故 意 让 服务 延迟 返回 ， 从 而 造成 不 可 用 的 后 果 。 

这 是 一 个 基本 的 Spring Boot 的 服务 ， 之 前 我 们 已 经 反复 讲述 过 ， 所 以 这 里 仅 给 出 实现 要 点 ， 
具体 信息 请 大 家 自己 参照 代码 。 

要 点 1， 在 pom.xml 里 引入 spring boot 的 依赖 项 ， 关 键 代 码 如 下 : 
<dependency> 

<groupId>org.springframework.boot</groupId> 

<artifactId>spring-boot-starter-web</artifactId> 


<version>1.5.4.RELEASE</version> 
</dependency> 


心 ww IN 


要 点 2， 在 ServerStarterjava 里 ， 开 启 服务 ， 代 码 如 下 : 


/ /省略 必要 的 package 和 import 代码 
@SpringBootApplication 
Public class ServerStarter{ 
Public static void main( String[] args ) 
由 
SpringApplication.run(ServerStarter.class, args); 
} 


oo amwwN 


} 
点 3， 在 控制 器 Controller.java 里 ， 编 写 两 个 提供 服务 的 方法 ， 代 码 如 下 : 


A 


瘟 


@RestController 
public class Controller { 
@RequestMapping (value = "/available", method = RequestMethod.GET ) 
Public String availabieService(){ 
return "This Server works well."; 
有 
@RequestMapping (value = "/unavailable", method = RequestMethod.GET ) 
public String unavailableServicve () { 
try { 
Thread.sleep (5000); 


oamwmwewm 


v0 


} 
catch (InterruptedException e){ 
e.printStackTrace (); 
} 


return "This service is unavailable."7 


HR FRR FF 
ao 心 w Nb 口 
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16 } 
Lh 


其 中 ， 在 第 4 行 提供 了 一 个 可 用 的 服务 ， 在 第 8~16 行 的 unavailableServicve 的 服务 里 ， 通 过 
第 10 行 的 sleep 方法 造成 “服务 延迟 返回 ”的 效果 。 


5.2.2 ”以 同步 方式 调用 正常 工作 的 服务 


这 里 我 们 新 建 一 个 HystrixClientDemo 项 目 ， 在 其 中 开发 各 种 Hystrix 调用 服务 的 代码 。 
在 这 个 项 目 里 ， 我 们 将 通过 Ribbon 和 Hystrix 结合 的 方式 ， 调 用 在 上 面 提供 的 服务 ， 所 以 在 
pom.xml 文件 里 将 引入 这 两 部 分 的 依赖 包 ， 关 键 代码 如 下 : 


1 <dependencies> 

<dependency> 

四 <groupId>com.netflix.ribbon</groupId> 

4 <artifactId>ribbon-httpclient</artifactId> 
5 <version>2.2.0</version> 

6 </dependency> 

<dependency> 

8 <groupId>com.netflix.hystrix</groupId> 
9 <artifactId>hystrix-core</artifactId> 
10 <version>1.5.12</version> 

JI </dependency> 

1] 之 </dependencies> 


在 上 述 代 码 的 第 2~6 行 里 , 我 们 引入 了 Ribbon 的 依赖 项 ; 在 第 7~11 行 里 , 我 们 引入 了 Hystrix 
的 依赖 项 。 

在 NormalHystrixDemo.java 里 , 我 们 将 演示 通过 Hystrix 调用 正常 服务 的 开发 方式 , 代码 如 下 : 

1 ，// 省 略 必要 的 package 和 import 代码 


2 // 继 承 HystrixCommand<String>， 所 以 run 方法 返回 String 类 型 对 象 

3 public class NormalHystrixDemo extends HystrixCommand<String> { 

4 // 定 义 访问 服务 的 两 个 对 象 

多 RestClient client = null; 

6 HttpRequest request = null; 

// 在 构造 函数 里 指定 命令 组 的 名 字 

8 public NormalHystrixDemo() { 

9 super (HystrixCommandGroupKey .Factory.asKey ("demo")); 

10 } 

人 // 在 initRestCclient 方法 里 设置 访问 服务 的 client 对 象 

12 Private void initRestClient() { 

3 client = (RestClient) 
ClientFactory.getNamedClient ("HelloCommand"); 

14 try { 

a request = HttpRequest.newBuilder() .uri (new 

URI("/available")) .build(); 

16 } catch (URISyntaxException e) 

让 7 { e.printSstackTrace(); } 

18 ConfigurationManager.getConfigInstance() .setProperty( 


"HelloCommand.ribbon.listOfServers", "localhost:8080"); 
19 } 
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在 第 12~19 行 的 initRestClient 方法 里 ， 我 们 做 好 了 以 基于 Ribbon 的 RestClient 对 象 访问 服务 
的 准备 工作 , 具体 而 言 , 在 第 13 行 里 通过 工厂 初始 化 了 client 对 象 , 在 第 18 行 设置 了 待 访问 的 url， 


在 第 15 行 


20 
21 
22 
23 
24 
25 
26 


27 
28 
29 
30 
3 
32 


我 们 在 第 20 行 定义 了 返回 String 类 型 的 run 方法 ， 这 里 的 返回 类 型 需 


设置 了 待 访问 的 服务 名 。 


protected String run() { 


System.out.println("In run"); 

HttpResponse response; 

String result = null; 

谍 工 六 
response = client.executeWithLoadBalancer (request); 
System.out.println("Status for URI:" + response. 
getRequestedURI()+ " is :" + response.getSstatus()); 
result = response.getEntity(String.class) 7 

} catch (ClientException e) 

{ e.printStackTrace();} 

catch (Exception e) {e.printStackTrace(); 和 
return "Hystrix Demo,result is: " + result; 


和 第 3 行 ( 上 一 段 代 


码 ) 里 本 类 继承 的 HystrixCommand 对 象 的 泛 型 一 致 。 其 中 ， 我 们 通过 第 25 行 的 代码 调用 服务 ， 


33 
34 
35 
36 
33 
38 
人 9 
40 
41 
42 
43 


44 
45 


} 


并 在 第 31 行 返 回 一 个 包括 调用 结果 的 String 字符 串 。 


Public static void main(String[] args) { 


NormalHystrixDemo normalDemo = new NormalHystrixDemo(); 
// 初 始 化 调用 服务 的 环境 

normalDemo .initRestClient() 7? 

// 睡眠 1 秒 
try {Thread.sleep(1000);} 

catch ES e) 

{e.printStackTrace (); 

// 调 用 execute 方法 后 ， 会 自动 地 执行 定义 在 第 20 行 的 run 方 法 
String result = normalDemo.execute(); 
System.out .Println("Call available function, result is:" + 
result); 


在 main 方法 里 ， 我 们 指定 了 如 下 工作 流程 。 
步骤 014 在 第 36 行 里 ， 通 过 调用 initRestClient 方法 完成 了 初始 化 的 工作 。 
步 又 024 在 第 42 行 里 执行 了 execute 方法 ， 这 个 方法 是 封装 在 HystrixCommand 方法 里 的 ， 


旦 调 


， 就 会 触发 第 20 行 的 run 方法 。 


这 里 一 旦 执行 execute 方法 ， 就 会 立即 (以 同步 的 方式 ) 执行 run 方法 ， 在 run 方法 返回 
结果 之 前 ， 代 码 是 会 阻塞 在 第 42 行 的 ， 即 不 会 继续 往 后 执行 。 


步骤 034 在 第 20 行 的 run 方法 里 ， 我 们 以 localhost:8080/available 的 方式 调用 了 服务 端的 服 


务 。 
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执行 整 段 代码 ， 会 看 到 如 下 打印 语句 ， 这 些 打印 语句 很 好 地 验证 了 上 面 讲述 的 过 程 流 程 。 


a In run 

2 Status for URI:http://localhost:8080/available is :200 

3 Call available function, result is:Hystrix Demo,result is: 
This Server works well. 


5.2.3 ”以 异步 方式 调用 服务 


在 上 部 分 的 Hystrix 案例 中 ， 请 求 是 被 依次 执行 的 ， 在 处 理 完 上 个 请 求 之 前 ， 后 一 个 请 求 处 于 
阻塞 等 待 状态 ， 这 种 Hystrix 同步 的 处 理 方式 适用 于 并 发 量 一 般 的 场景 。 

单 台 服务 器 的 负载 处 理 能 力 毕 竟 是 有 限 的 ， 如 果 并 发 量 高 于 这 个 极限 ， 那 么 我 们 就 得 考虑 采 
用 Hystrix 基于 异步 的 保护 机 制 ， 从 图 5.1 里 ， 我 们 能 看 到 基于 异步 处 理 的 效果 图 。 


[Eystrix 队 列 服务 器 1 


高 并 发 的 请 求 | 2 


服务 器 n 
图 5.1 Hystrix 异步 处 理 的 效果 图 
从 图 5.1 里 我 们 能 看 到 ， 请 求 不 是 被 同步 地 立即 执行 ， 而 是 被 放 入 一 个 队列 (queue) 中 ， 封 


装 在 HystrixCommand 的 处 理 代 码 是 从 queue 里 拿 出 请 求 ， 并 以 基于 Hystrix 保护 措施 的 方式 处 理 
该 请 求 。 在 下 面 的 AsyncHystrixDemo.java 里 ， 我 们 将 演示 Hystrix 异步 执行 的 方式 。 


1 “// 省 略 必要 的 package 和 import 代码 
2 // 这 里 同样 是 继承 HystrixCommand<String> 类 
3 public class AsyncHystrixDemo extends HystrixCommand<String> { 
4 RestClient client = null; 
5 HttpRequest request = null; 
6 Public AsyncHystrixDemo() { 
也 // 指定 命令 组 的 名 字 
8 super (HystrixCommandGroupKey .Factory.asKey ("ExampleGroup")); 
9 } 
10 Private void initRestClient() { 
Tl client = (RestClient) 
ClientFactory.getNamedClient ("AsyncHystrix"); 
2 ty { 
3 request = HttpRequest.newBuilder() .uri (new 
URI("/available")) .build(); 
14 } 
15 catch (URISyntaxException e) 
16 { e.printStackTrace(); } 
17 ConfigurationManager .getConfigInstance () .setProperty( 
18 "AsyncHystrix.ribbon.listOfServers", "localhost:8080"); 
19 } 
20 protected String run() { 
之 于 System.out .Println("In run"); 
22 HttpResponse response; 
2 String result = null; 
24 try { 
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response = client .executeWithLoadBalancer (request); 
System.out.println("Status for URI:" + response. 
getRequestedURI() + " is :" + response.getStatus()); 
result = response.getEntity(String.class); 

} 

catch (ClientException e) {e.PrintStackTrace()7 } 

catch (Exception e) { e.printstackTrace(); } 

return "Hystrix Demo,result is: " + result; 


在 上 述 代 码 的 第 6 行 中 ， 我 们 定义 了 构造 函数 ; 在 第 10 行 中 ， 定 义 了 初始 化 Ribbon 环境 的 
initRestClient 方法 ; 在 第 20 行 中 ， 定 义 了 执行 Hystrix 业务 的 run 方法 。 这 3 个 方法 和 刚才 讲 到 的 
NormalHystrixDemo 类 里 很 相似 ， 所 以 就 不 再 详细 讲述 了 。 
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public static void main (String[] args) { 


AsyncHystrixDemo asyncDemo = new AsyncHystrixDemo(); 
asyncDemo.initRestClient (); 
Ery if Thread.sleep (1000);} 
catch (InterruptedException e) 
{fe.PrintStackTrace () 7 
// 上 述 代码 是 初始 化 环境 并 sleep 1 秒 
// 得 到 Future 对 象 
Future<String> future = asyncDemo.queue(); 
String result = null; 
try { 
System.out.println("Start Async Call"); 
// 通 过 get 方法 以 异步 的 方式 调用 请 求 
result = future.get(); 
} catch (InterruptedException e) 
{ e.printStackTrace ();} 
catch (ExecutionException e) 
{ e.printStackTrace () 7 } 
System.out.println("Call available function, result is:" + 
result); 


在 main 函数 的 第 34~38 行 , 我 们 同样 初始 化 了 Ribbon 环境 ,这 和 之 前 的 NormalHystrixDemo 
类 的 做 法 是 一 样 的 。 

在 第 41 行 里 , 我 们 通过 queue 方法 得 到 了 一 个 包含 调用 请 求 的 Future<String> 类 型 的 对 象 。 而 
在 第 46 行 里 ， 我 们 通过 future 对 象 的 get 方法 执行 请 求 。 

这 里 有 两 个 看 点 : 第 一 ， 在 执行 第 46 行 的 get 方法 后 ，HystrixComman 会 自动 调用 定义 在 第 
20 行 的 run 方法 : 第 二 ， 这 里 得 到 请 求 对 象 是 在 第 41 行 ， 而 调用 请 求 则 在 第 46 行 ， 也 就 是 说 ， 
并 不 是 在 请 求 到 达 时 就 立即 执行 ， 而 是 通过 异步 的 方式 执行 。 

本 部 分 代码 的 执行 结果 和 NormalHystrixDemo.java 是 一 样 的 ， 所 以 就 不 再 给 出 了 。 


5.2.4 ”调用 不 可 用 服务 会 启动 保护 机 制 


刚才 我 们 是 通过 Hystrix 调用 正常 工作 的 服务 ， 也 就 是 说 ，Hystrix 的 保护 机 制 并 没有 起 作用 ， 
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这 里 我 们 将 在 HystrixProtectDemo.java 里 演示 调用 不 可 用 的 服务 时 Hystrix 启动 保护 机 制 的 流程 。 
这 个 类 是 基于 NormalHystrixDemo.java 改写 的 ， 只 是 在 其 中 增加 了 getFallback 方法 ， 代 码 如 下 : 
// 省 略 必 要 的 package 和 import 代码 


Public class HystrixProtectDemo extends HystrixCommand<String> { 


} 


RestClient client = null; 
HttpRequest request = null; 
// 构 造 函数 很 相似 
public HystrixDemoProtectDemo() { 
super (HystrixCommandGroupKey .Factory.asKey ("ExampleGroup")); 
} 
//initRestClient 方法 没 变 
Private void initRestClient(){ 


// 和 NormalHystrixDemo.java 一 样 ， 具 体 请 参考 代码 


} 
//run 方 法 也 没 变 
protected String run() { 


// 和 NormalHystrixDemo.java 一 样 ， 具 体 请 参考 代码 


} 
// 这 次 多 个 了 getFallback 方法 ， 一 旦 出 错 ， 会 调用 其 中 的 代码 
Protected String getFallback() { 

// 省 略 跳 转 到 错误 提示 页 面 的 动作 


return "Call Unavailable Service."; 


} 
//main 函数 
Public static void main(String[] args) { 
HystrixDemoProtectDemo normalDemo = new HystrixDemoProtectDemo (); 
normalDemo.initRestClient (); 
Ey 
Thread.sleep (1000); 
} catch (InterruptedException e) { 
e.printStackTrace (); 
’ 
String result = normalDemo.execute(); 
System.out.println("Call available function, result is:" + 
result); 


这 个 类 里 的 构造 函数 和 NormalHystrixDemo.java 很 相似 , 而 initRestClient 和 run 方法 根本 没 变 ， 
所 以 就 不 再 详细 给 出 了 。 
在 第 18 行 里 ， 我 们 重 写 了 HystrixCommand 类 的 getFallback 方法 ， 在 其 中 定义 了 一 旦 访问 出 
背 的 动作 ， 这 里 仅仅 是 输出 一 段 话 ， 在 实际 的 项 目 里 可 以 跳 转 到 相应 的 错误 提示 页 面 。 
而 main 函数 里 的 代码 和 NormalHystrixDemo.java 里 的 完全 一 样 ， 只 是 在 运行 这 段 代码 前 无 须 
运行 HystrixServerDemo 项 目的 启动 类 ， 这 样 服务 一 定 是 调用 不 到 的 。 运 行 本 段 代码 后 ， 我 们 能 


到 如 下 结果 。 
了 In run 
受 Call available function, result is:Call Unavailable Service. 


从 第 2 行 的 输出 上 , 我 们 能 确认 , 一 旦 调用 服务 出 错 , Hystrix 处 理 类 就 能 自动 调用 getFallback 
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方法 。 

如 果 这 里 没有 定义 getFallback 方法 ， 那 么 一 旦 服务 不 可 用 ， 用 户 就 可 能 在 连接 超时 之 后 在 浏 
览 器 里 看 到 一 串 毫 无 意义 的 内 容 ,这 样 用 户 体验 就 很 差 了 .如 果 整 个 系统 的 其 他 容错 措施 也 没 到 位 ， 
甚至 有 可 能 会 导致 当前 和 下 游 模 块 瘫痪 。 

相反 ， 在 这 里 我 们 在 Hystirx 提供 的 getFallback 方法 里 做 了 充分 的 准备 ， 一 旦 出 现 错误 ， 这 段 
错误 处 理 的 代码 就 能 被 立即 触发 ， 其 效果 就 相当 于 熔断 后 继 的 处 理 流程 。 由 getFallback 出 面 ， 友 
好 地 告知 用 户 出 问题 了 ， 以 及 后 继 该 如 何 处理 。 这 样 一 方面 能 及 时 熔断 请 求 ， 从 而 保护 整个 系统 ; 
另 一 方面 ， 不 会 造成 因 体验 过 差 而 使 用 户 大 规模 流失 的 情况 。 


5.2.5 ”调用 Hystrix 时 引入 缓存 


如 果 每 次 请 求 都 要 走 后 台 应 用 程序 乃至 再 到 数据 库 检 索 一 下 数据 ， 这 对 服务 器 的 压力 太 大 ， 
有 时 候 这 一 因素 甚至 会 成 为 影响 网 站 服务 性 能 的 瓶颈 。 所 以 , 大 多 数 网 站 会 把 一 些 无 须 实 时 更 新 的 
数据 放 入 缓存 ， 前 端 请 求 到 缓存 里 拿 数 据 。 

Hystrix 在 提供 保护 性 便利 的 同时 , 也 能 支持 缓存 的 功能 , 在 下 面 的 HystrixCacheDemo.java 里 ， 
我 们 将 演示 Hystrix 从 缓存 中 读 取 数据 的 步 又， 代码 如 下 : 

1 “// 省 略 必要 的 package 和 import 代码 


2 public class HystrixCacheDemo extends HystrixCommand<String> { 
3 用 Ra 

4 Integer id; 

5 // 用 一 个 HashMap 来 模拟 数据 库 里 的 数据 

6 Private HashMap<Integer,String> userList = new 


HashMap<Integer, String>(); 


// 构 造 函数 

8 public HystrixCacheDemo (Integer id) { 

EE super (HystrixCommandGroupKey .Factory.asKey ("RequestCacheCommand")); 
10 this.id = id; 

1 userList.put (1, "Tom"); 

12 } 


在 第 3 行 里 ， 我 们 定义 了 一 个 用 户 id， 并 在 第 6 行 定义 了 一 个 存放 用 户 信 息 的 HashMap。 在 
第 8~12 行 的 构造 函数 里 ， 我 们 在 第 10 行 用 参数 id 来 初始 化 本 对 象 的 id 属性 ， 并 在 第 11 行 通过 
put 方法 模拟 地 构建 了 一 个 用 户 。 在 项 目 里 ， 用 户 的 信息 其 实 是 存在 数据 库 里 的 。 


1 protected String run() { 

14 System.out .Println("In run"); 
二 return UserList.get(id) 

16 } 


如 果 不 走 缓存 ， 那 么 第 13~16 行 定义 的 run 函数 将 会 被 execute 方法 触发 ， 在 其 中 的 第 15 行 
中 ， 我 们 通过 get 方法 从 userList 这 个 HashMap 里 获得 一 条 用 户 数据 ， 这 里 我 们 用 get 方 法 来 模拟 
根据 id 从 数据 库 里 获取 数据 的 诸多 动作 。 

hr! protected String getCacheKey() { 


18 return String.valueOf (id); 
19 } 


第 5 章 服务 容错 组 件 : HyStrix 


| 


81 


第 17 行 定义 的 getCacheKey 方法 是 Hystrix 实现 缓存 的 关键 , 在 其 中 我 们 可 以 定义 “缓存 对 象 
的 标准 ”具体 而 言 ,我 们 在 这 里 是 返回 String.valueOfid), 也 就 是 说 ,如果 第 二 个 HystrixCacheDemo 
对 象 和 第 一 个 对 象 具有 相同 的 String.valueOf(id) 的 值 ， 那 么 第 二 个 对 象 在 调用 execute 方法 时 就 可 
以 走 缓存 。 


20 
21 
22 


23 
24 
25 
26 


39 


public static void main(String[] args) { 


// 初 始 化 上 下 文 ， 否 则 无 法 用 缓存 机 制 


HystrixRequestContext context = 

HystrixRequestContext .initializeContext (); 

// 定 义 两 个 具有 相同 id 的 对 象 

HystrixCacheDemo cacheDemol = new HystrixCacheDemo(1); 
HystrixCacheDemo cacheDemo2 = new HystrixCacheDemo (1); 
// 第 一 个 对 象 调用 的 是 run 方法 ， 没 有 走 缓存 

System.out .Println("the result for cacheDemol is:" + 
cacheDemol .execute () ) 

System.out .Println("whether get from cache: " + 
cacheDemol .isResponseFromCache); 

// 第 二 个 对 象 ， 由 于 和 第 一 个 对 象 具有 相同 的 td， 所 以 走 缓存 
System.out .Println("the result for cacheDemo2 is:" + 
cacheDemo2 .execute()); 

System.out.println ("whether get from cache: " + 
cacheDemo2 .isResponseFromCache) 7 

// 销 魂 上 下 文 ， 以 清空 缓存 

context.shutdown (); 

// 再 次 初始 化 上 下 文 ， 但 由 于 缓存 已 清 ， 所 以 cacheDemo3 没 走 缓存 
context = HystrixRequestContext.initializeContext (); 

HystrixCacheDemo cacheDemo3 = new HystrixCacheDemo (1); 


System.out.println("the result for 3 is:" + cacheDemo3.execute()); 


System.out .Println("whether get from cache: "+ 
cacheDemo3 .isResponseFromCache) 
context .shutdown (); 


在 第 20 行 定义 的 main 方法 里 ， 我 们 定义 了 如 下 的 几 条 主要 逻辑 。 
第 一 ， 在 第 22 行 ， 通过 initializeContext 方法 初始 化 了 上 下 文 ， 这 样 才能 启动 缓存 机 制 ; 在 第 
24~25 行 里 ， 我 们 创建 了 两 个 不 同名 但 相同 id 的 HystrixCacheDemo 对 象 。 
第 二 ， 在 第 27 行 里 ， 我 们 通过 cacheDemol 对 象 的 execute 方法 根据 id 查找 用 户 ， 虽 然 在 这 
里 是 通过 run 方法 里 第 15 行 的 get 方法 从 HashMap 里 取 数 据 ， 但 是 大 家 可 以 把 这 想象 成 从 数据 表 
里 取 数 据 。 
第 三 ， 在 第 30 行 里 ， 我 们 调用 了 cacheDemo2 对 象 的 execute 方法 ， 由 于 它 和 cacheDemol 对 


象 具有 相同 的 id， 因 此 这 里 六 


拿 数据 ， 这 就 可 以 避免 因 多 次 访问 数据 库 而 造成 系统 损耗 了 。 

第 四 ， 我 们 在 第 33 行销 毁 了 上 下 文 ， 并 在 第 35 行 里 重新 初始 化 了 上 下 文 ， 之 后 ， 昌 然 在 第 
36 行 定 义 的 cacheDemo3 对 象 的 id 依然 是 1, 但 是 由 于 上 下 文 对 象 被 重 置 过 , 其 中 的 缓存 也 被 清空 ， 
因此 在 第 37 里 执行 的 execute 方法 并 没有 走 缓存 。 


运行 上 述 代 码 ， 我 们 能 看 到 如 下 输出 ， 这 些 打印 结果 能 很 好 地 验证 上 述 对 主要 流程 的 说 明 。 
1 


In run 


FF 没有 走 execute 方法 ， 而 是 直接 从 保存 cacheDemol.execute 的 缓存 里 
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the result for cacheDemol is:Tom 
whether get from cache: false 
the result for cacheDemo2 is:Tom 
whether get from cache: true 

In run 

the result for 3 is:Tom 


这 里 请 大 家 注意 ， 在 缓存 相关 的 getCacheKey 方法 里 ， 我 们 不 是 定义 “保存 缓存 值 ”的 逻辑 ， 
而 是 定义 “缓存 对 象 的 标准 ”， 初 学 者 经 常会 混淆 这 一 点 。 具 体 而 言 ， 在 这 里 的 getCacheKey 方法 
里 , 我 们 并 没有 保存 id 是 1 的 User 对 象 的 值 (这 里 是 Tom) ， 而 是 定义 了 如 下 标准 : 只 要 两 个 (或 
多 个 ) HystrixCacheDemo 对 象 具有 相同 的 String.valueOfid) 的 值 ， 而 且 缓 存 中 也 已 经 存 有 id 的 1 
的 结果 值 ， 那 么 后 继 对 象 则 可 以 直接 从 缓存 里 读数 据 。 


auwcwn 


5.2.6 ”归纳 Hystrix 的 基本 开发 方式 


在 上 文 里 ， 我 们 演示 了 通过 Hystrix 调用 可 用 以 及 不 可 用 服务 的 运行 结果 ， 并 在 调用 过 程 中 引 
入 了 缓存 机 制 ， 这 里 ， 我 们 将 在 上 述 案 例 的 基础 上 归纳 Hystrix 的 一 般 工 作 流程 。 

第 一 ， 我 们 可 以 通过 extends HystrixCommand<T> 的 方式 让 一 个 类 具备 Hystrix 保护 机 制 的 特 
性 ， 其 中 T 是 泛 型 ， 在 上 述 案例 中 我 们 用 到 的 是 String。 

第 二 ， 一 旦 继承 了 HystrixCommand 之 后 , 我 们 就 可 以 通过 重 写 run 方法 和 getFallback 方法 来 
定义 调用 “可 用 ”和 “不 可 用 ”服务 的 业务 功能 代码 。 其 中 ， 这 两 个 方法 的 返回 值 需要 和 第 一 步 里 
定义 的 泛 型 T 一 致 。 而 在 项 目 里 ， 我 们 一 般 在 getFallback 方法 里 定义 “服务 不 可 用 ”时 的 保护 措 
施 〈 也 就 是 后 文 里 将 要 提 到 的 降级 措施 ) 。 

第 三 ， 我 们 还 可 以 通过 缓存 机 制 来 降低 并 发 情况 下 对 服务 器 的 压力 。 在 Hystrix 里 ， 我 们 可 以 
在 getCacheKey 里 定义 “判断 可 以 走 缓存 对 象 的 标准 ”。 

在 使 用 缓存 时 ， 请 注意 两 点 : 第 一 ， 需 要 开启 上 下 文 ， 第 二 ，Hystrix 会 根据 定义 在 类 里 的 属 
性 判断 多 次 调用 的 对 象 是 否 是 同一 个 ， 如 果 是 ， 而 且 之 前 被 调用 过 ， 就 可 以 走 缓存 。 


5.3 ”通过 Hystrix 实践 各 种 容错 保护 机 制 


在 上 文 里 ， 我 们 初步 了 解 了 Hystrix 的 开发 流程 和 工作 原理 ， 这 里 我 们 将 根据 一 些 项 目 里 遇 到 
4 常见 场景 讲述 Hystrix 各 种 容错 保护 机 制 的 使 用 场景 的 常规 开发 方式 。 


5.3.1 ”强制 开启 或 关闭 断路 器 


在 前 文 里 我 们 能 看 到 ， 如 果 调 用 execute 失败 ，Hystrix 就 会 通过 调用 getFallback 方法 触发 加 
退 (fallback) 流程 。 

事实 上 ，Hystrix 的 支持 类 库 能 根据 Hystrix 断路 器 的 值 动 态 地 决定 是 否 会 走 回 退 流程 , 具体 而 
言 ， 如 果断 路 器 处 于 打开 (open) 状态 ， 哪 怕 通 过 execute 调用 的 方法 是 处 于 可 用 状态 也 会 走 回 退 
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流程 ， 即 调用 getFallback 方法 。 

我 们 可 以 通过 hystrix.command.default.circuitBreaker.forceOpen 属性 强制 地 开启 或 关闭 断路 器 。 
在 下 面 的 CurcuitBreakerDemo.java 里 ， 我 们 将 演示 这 一 做 法 。 

1  // 省 略 必要 的 package 和 import 方法 

2 public class CurcuitBreakerDemo extends HystrixCommand<String>{ 
3 ”// 构 造 函 数 
4 


public CurcuitBreakerDemo() { 
super (HystrixCommandGroupKey.Factory.asKey ("CurcuitBreaker")); 


5 } 

6 // 封 装 正常 调用 流程 的 run 方法 

ya protected String run() { 

8 System.out .Println("In run"); 
9 return "run"7 

10 } 

11 // 封 装 调用 失败 保护 逻辑 的 getFallback 方法 
bp Protected String getFallback() { 
13 System.out .println("In FallBack"); 
14 return "In FallBack"; 

45 } 

16 


上 述 定义 的 方法 我 们 之 前 都 见 过 ， 在 一 般 情况 下 ， 第 7 行 定义 的 run 方法 会 被 调用 execute 时 
触发 ， 如 果 调 用 服务 失败 ， 则 会 触发 第 12 行 定义 的 getFallBack 方法 。 


7 Public static void main(String[] args) { 
18 // 断路 器 被 强制 打开 


ConfigurationManager.getConfigInstance() .setProperty( 
"hystrix.command.default .circuitBreaker.forceOpen", "true"); 


CurcuitBreakerDemo demol = new CurcuitBreakerDemo(); 
20 demol .execute () ; // 会 输出 In FallBack 
2 // 创建 第 二 个 命令 ， 断 路 器 关闭 


ConfigurationManager .getConfigInstance () .setProperty( 
"hystrix.command.default.circuitBreaker.forceOpen"， "false"); 


22 CurcuitBreakerDemo demo2 = new CurcuitBreakerDemo () 
这 3 demo2 .execute () ; // 会 输出 In Run 

24 } 

人 


从 第 17 行 开始 的 main 函数 里 ， 我 们 分 别 在 第 18~21 行 ， 通 过 ConfigurationManager 对 象 把 
hystrix.command.default.circuitBreaker.forceOpen 属性 设置 成 true 和 false。 

我 们 能 看 到 ， 当 设置 成 true 之 后 ， 在 第 20 行 调用 的 execute 方法 会 直接 走 getFallBack 流程 ， 
而 不 走 正常 的 run 方法 ， 相 反 ， 如 果 设 置 成 false 之 后 ， 则 会 调用 run 方法 。 

这 里 仅仅 是 给 大 家 演示 强制 开启 和 关闭 断路 器 的 做 法 ， 在 实际 项 目 中 ， 一 般 会 根据 服务 调用 
链 路 的 实际 情况 ， 动 态 地 开启 或 关闭 断路 器 ， 这 部 分 的 知识 我 们 将 在 后 文 里 详细 描述 。 


5.3.2 ”根据 流量 情况 按 命令 组 开启 断路 器 


日 常生 活 中 的 保险 丝 不 会 一 直 开 启 ， 这 样 起 不 到 保护 作用 ， 当 然 更 不 会 一 直 断 开 ， 而 是 会 被 
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过 载 的 电流 “熔断 ”。 

Hystrix 里 的 断路 器 也 会 被 过 载 的 流量 自动 熔断 ， 从 而 起 到 保护 作用 。 不 过 ， 为 了 保持 服务 链 
路 稳定 ， 断 路 器 也 不 能 随意 开启 ， 默 认 情 况 下 ， 在 同时 满足 如 下 两 个 条 件 的 情况 下 才能 熔断 。 

第 一 ， 在 每 个 计量 窗口 时 间 范 围 内 (默认 是 10 秒 ) ， 请 求 数 超过 阔 值 ， 默 认 是 20 个 。 

第 二 ， 在 满足 第 一 个 条 件 的 情况 下 ， 如 果 处 理 请 求 的 错误 率 超 过 阔 值 (默认 是 50%) ， 那 么 
断路 器 就 会 开启 一 段 时间 。 

在 给 出 具体 的 案例 前 ， 我 们 先 来 讲解 一 下 和 熔断 相关 的 各 参数 的 含义 。 我 们 刚才 提 到 了 “ 计 
量 窗口 时 间 范 围 ” 这 个 概念 , 这 可 以 由 hystrix.command.default.metrics.rollingStats.timeInMilliseconds 
参数 决定 ， 默认 值 是 10000， 单 位 是 微 秒 ， 即 10 秒 。 在 表 5.1 里 ,我 们 列 出 了 其 他 相关 常用 参数 的 
用 法 。 


表 5.1 和 熔断 相关 的 参数 的 含义 


hystrix.command.default'circuitBreaker。 | 每 个 计量 窗口 内 最 小 的 请 求 数 。 默 认 是 20， 即 如 果 收 到 
requestVolumeThreshold 19 个 请 求 ， 哪 怕 都 失败 ， 也 不 会 开启 断路 器 


断路 后 的 持续 时 间 值 , 默认 为 5000, 即 熔断 开启 后 5000 
sleep WindowInMilliseconds 毫秒 内 都 会 拒绝 请 求 ， 过 此 时 间 后 开始 尝试 是 否 恢复 
错误 比率 阔 值 ， 默 认 是 50， 即 如 果 错误 率 超过 该 值 ， 断 

errorThresholdPercentage 路 器 会 开启 


在 下 面 的 CurcuitBreakerCloseDemo.java 里 ， 我 们 将 演示 过 载 的 流量 导致 断路 器 熔断 的 场景 。 
1 // 省 略 必要 的 package 和 import 的 代码 


2 public class CurcuitBreakerCloseDemo extends HystrixCommand<String>{ 

3 ”// 在 构造 函数 里 ， 设 置 每 个 服务 的 Timeout 时 间 最 长 等 待 时 间 ) 是 500 毫秒 

4 Public CurcuitBreakerCloseDemo() {super(Setter. 
withGroupKey (HystrixCommandGroupKey .Factory. 
asKey ("HystrixGroup")) .andCommandPropertiesDefaults 
(HystrixCommandProperties.Setter(). 
withExecutionTimeoutInMilliseconds (500))); 

5 

6 // 故 意 在 run 方法 里 sleep 500 毫秒 ， 从 而 导致 请 求 失败 

kh protected String run() throws Exception { 

8 // 模拟 处 理 超时 

9 Thread.sleep (500) 

了 人 return "Run"; 

11 } 

12 ”// 定 义 回 退 的 逻辑 ， 返 回 一 段 话 

3 Protected String getFallback() 

14 { return "FallBack"; } 


在 上 文 构造 函数 的 第 4 行 里 ,我 们 通过 设置 属性 定义 了 每 个 服务 的 最 长 等 待 时 间 是 500 毫秒 ， 
而 在 第 7~11 行 的 run 方法 里 故意 设置 了 500 毫秒 的 睡 卢 ， 以 模拟 服务 调用 超时 失败 的 情况 。 


15. Public static void main (String[] args) throws Exception { 
16 // 10 秒 内 有 5 个 请 求 
ConfigurationManager .getConfigInstance () .setProperty( 


"hystrix.command.default.metrics.rollingStats . 
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timeInMilliseconds", 10000); 


18 ConfigurationManager.getConfigInstance () .setProperty ("hystrix. 
command.default .circuitBreaker.requestVolumeThreshold", 5); 
19 ConfigurationManager.getConfigInstance() .setProperty( 


"hystrix.command.default .circuitBreaker. 
errorThresholdPercentage", 50); 


20 // 用 for 循环 模拟 多 次 调用 请 求 


2 ForAioE dm OT CO JA) 

22 // 执行 的 命令 全 部 都 会 超时 

23 CurcuitBreakerCloseDemo c = new CurcuitBreakerCloseDemo(); 

24 c.execute(); 

25 // 断路 器 打开 后 输出 信息 

26 if(c.isCircuitBreakerOpen()==true) { 

2 了 System.out .Println("Curcuit Breaker is open, running "+ 
(1) "case™)y 

28 ’ 

29 } 

30 } 

3 


在 main 函数 的 第 17~19 行 里 ， 我 们 做 了 一 些 设置 : 计量 时 间 范 围 是 10000 毫秒 〈 也 就 是 10 
秒 ) ， 在 每 个 计量 时 间 范 围 内 ， 只 要 有 5 个 以 上 的 请 求 ， 以 及 请 求 的 错误 率 高 于 50%， 就 会 开启 
断路 器 。 设 置 完成 后 ， 在 第 21~28 We for 循环 里 ， 我 们 用 第 24 行 的 execute 方法 模拟 了 10 次 请 
求 调用 。 运 行 后 ， 能 看 到 如 下 的 输出 结果 
Curcuit Breaker is open, running 6 case 
Curcuit Breaker is open, running 7 case 
Curcuit Breaker is open, running 8 case 
Curcuit Breaker is open, running 9 case 
Curcuit Breaker is open, running 10 case 

按照 我 们 的 设置 ， 在 10 秒 里 ， 请 求 数 如 果 大 于 5， 而 且 错 误 率 高 于 50% (这 里 是 100%) ， 
就 会 开启 断路 器 ， 所 以 从 第 6 个 请 求 开始 ， 我 们 能 看 “断路 器 开启 ”的 相关 打印 语句 。 


wa 心 wN 


“熔断 ”是 针对 命令 组 而 言 的 ,在 上 述 案例 的 第 4 行 , 我 们 指定 的 命令 组 是 HystrixGroup， 


断路 器 开启 后 ， 只 有 在 这 个 组 里 的 封装 在 execute 方法 里 的 命令 请 求 才 会 被 熔断 ， 包 含 在 
其 他 命令 组 里 的 请 求 依然 会 被 正常 执行 ， 不 会 被 熔断 。 


5.3.3 ”降级 服务 后 的 自动 恢复 尝试 措施 


当 服 务 链 路 被 并 发 量 大 的 请 求 熔断 时 ， 整 个 系统 就 进入 降级 模式 ， 比 如 把 过 载 的 请 求 定 位 到 
蕴 误 提示 页 面 上 。 

这 种 服务 降级 其 实 是 不 得 已 而 为 之 的 ， 所 以 应 该 在 过 载 的 流量 消退 后 ， 尽 快 恢复 正常 的 业务 
功能 。 为 了 实现 这 样 的 功能 ，Hystrix 提供 了 这 样 的 便利 : 程序 员 可 以 事先 设置 一 个 时 间 段 ， 即 表 
5.1 里 给 出 的 参数 hystrix.command.default.circuitBreaker.sleepWindowInMilliseconds， 当 断路 器 开启 
后 ， 降 级 模式 会 持续 这 个 指定 的 时 间 段 ， 过 后 Hystrix 会 再 次 检查 链 路 的 流量 情况 ， 会 按 当 前 的 负 
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载 情况 再 行 决定 是 继续 熔断 还 是 恢复 正常 。 
在 CurcuitBreakerRestoreDemo.java 的 案例 中 ， 我 们 将 根据 实际 项 目 里 的 场景 综合 演示 服务 降 
级 以 及 恢复 的 做 法 ， 包 含 如 下 看 点 。 


第 一 ， 有 些 模块 会 同时 给 其 他 多 个 模块 提供 服务 ， 比 如 会 员 管理 模块 会 同时 给 订单 管理 、 优 
惠 券 管理 和 博客 模块 提 供 服 务 一 旦 会 员 管 理 模块 请 求 负载 过 重 , 应当 优先 保证 向 一 些 重要 的 模块 
《比如 订单 管理 模块 ) 提供 服务 ,相应 的 ,可 以 熔断 一 些 来 自 优先 级 比较 低 的 模 央 (比如 博客 模块 ) 
的 请 求 。 

第 二 ， 当 流量 负载 过 高 时 ， 确 实 应 当 通 过 断路 器 熔断 一 些 请 求 ,但 最 好 是 在 熔断 后 的 某 个 时 间 
段 后 再 次 尝试 。 因 为 在 这 个 时 间 点 流量 可 能 已 经 恢复 正常 ， 这 时 就 应 当 终止 降级 模式 。 


下 面 我 们 按 部 分 讲解 这 个 案例 。 


// 省 略 必 要 的 package 和 import 方法 
// 这 是 个 会 员 管理 模块 
class UserInfo extends HystrixCommand<String>{ 
// 设置 超时 的 时 间 为 500 毫秒 
Public UserInfo() { super (Setter.withGroupKey 
(HystrixCommandGroupKey .Factory.asKey ("HystrixGroup"))); 
} 
protected String run() throws Exception { 
// 返回 用 户 信息 


return "Peter"; 


mwN PP 


PP oo ~ 


0 } 
Lea 


在 第 3~11 行 定义 的 UserInfo 类 里 ， 我 们 模拟 地 实现 了 用 户 信息 管理 模块 的 功能 ， 在 第 7 行 的 
run 方法 里 ， 该 模块 返回 一 个 用 户 信息 “Peter”。 


12 public class CurcuitBreakerRestoreDemo extends HystrixCommand<String>{ 

13 // 设置 超时 的 时 间 为 500 毫秒 

14 public CurcuitBreakerRestoreDemo() {super(Setter.withGroupKey 
(HystrixCommandGroupKey .Factory.asKey ("HystrixGroup")). 
andCommandPropertiesDefaults (HystrixCommandProperties.Setter(). 
withExecutionTimeoutInMilliseconds (500))); 


5 } 

16 protected String run() throws Exception { 
17 // 模拟 处 理 超时 

18 Thread.sleep (500) 7 

19 return new UserInfo() .execute(); 

20 } 

21 @Override 

22 protected String getFallback() { 

之 3 return "FallBack"; 

24 } 


在 上 述 的 构造 函数 中 ，run 方法 与 getFallback 方法 和 CurcuitBreakerCloseDemo 类 里 的 是 一 样 
的 ， 所 以 就 不 再 分 析 了 。 


25 Public static void main (String[] args) throws Exception { 


26 // 10 秒 内 有 5 个 请 求 
2 ConfigurationManager .getConfigInstance () .setProperty( 
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"hystrix.command.default .metrics.rollingstats. 
timeInMilliseconds", 10000); 

28 ConfigurationManager .getConfigInstance () .setProperty( 
"hystrix.command.default.circuitBreaker. 
requestVolumeThreshold", 5); 

29 ConfigurationManager.getConfigInstance() .setProperty( 
"hystrix.command.default .circuitBreaker. 
errorThresholdPercentage", 50); 

30 ConfigurationManager.getConfigInstance() .setProperty( 
"hystrix.command.default .circuitBreaker. 
sleepWindowInMilliseconds", 5000); 


31 // 通 过 for 循环 开启 7 个 请 求 ， 故 意 造成 熔断 的 效果 

加 多 fon(tintE T= Od < Te ER 

33 // 执行 的 命令 全 部 都 会 超时 

34 CurcuitBreakerRestoreDemo c = new 
CurcuitBreakerRestoreDemo(); 

35 c.execute(); 

36 // 断路 器 打开 后 输出 信息 

37 if(c.isCircuitBreakerOpen()) { 

38 System.out .Println("Curcuit Breaker is open, running "+ 

Cm LU dm case™)ls 

39 » 

40 } 

41 //sleep 6 秒 ， 错 开 熔 断后 的 等 待 时间 

42 Thread.sleep(6000) 

43 System.out .Println("Rfter 6 seconds"); 

44 CurcuitBreakerRestoreDemo c = new CurcuitBreakerRestoreDemo () 

45 System.out .Println(c.execute ()) 7 

46 } 

47 } 


在 main 函数 的 第 27~30 行 里 ， 我 们 做 了 如 下 设置 : 计量 时 间 范 围 是 10000 毫秒 (也 就 是 1 
秒 ) ， 在 每 个 计量 时 间 范 围 内 ， 只 要 有 5 个 以 上 的 请 求 ， 以 及 请 求 的 错误 率 高 于 50%， 和 
断路 器 ， 而 且 当 断路 器 开启 5 秒 后， 会 再 次 自动 尝试 。 

所 以 从 第 32 行 开始 的 for 循环 里 ， 我 们 能 看 到 关于 断路 器 打开 的 打印 。 在 之 后 的 第 42 行 里 ， 
我 们 故意 让 当前 线程 sleep 6 秒 ， 以 错开 断路 器 的 等 待 时 间 。 在 之 后 的 第 45 行 里 ， 当 我 们 再 次 请 求 
会 员 管 理 模块 的 服务 时 ， 服 务 已 恢复 正常 。 

本 程序 的 运行 结果 能 很 好 地 验证 上 述 讲 解 ， 其 中 从 前 两 行 的 打印 中 我 们 能 看 到 断路 器 已 经 开 
启 ， 在 第 4 行 的 输出 语句 里 我 们 能 看 到 会 员 服务 已 经 恢复 正常 。 


1 Curcuit Breaker is open, running 6 case 
2 Curcuit Breaker is open, running 7 case 
3 After 6 seconds 

4 Better 


5.3.4 ”线程 级 别 的 隔离 机 制 


在 实际 的 Web 项 目 里 ,我 们 往往 会 为 各 功能 模块 设置 一 个 最 大 线程 数 上 限 ， 这 种 “隔离 管理 
做 法 的 用 意 是, 一 旦 某 个 模块 (比如 订单 管理 模块 流量 负载 过 大 ， 即使 熔断 ， 影 响 范围 也 只 是 本 
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模块 ， 不 会 影响 到 整个 系统 。 
对 应 地 ，Hystrix 也 提供 了 “线程 隔离 ”和 “信号 量 隔离 ”的 两 种 保护 措施 ， 哪 怕 断 路 器 没 开 ， 
只 要 该 请 求 所 在 的 线程 池 (或 信号 量 ) 资源 满 了 ， 也 会 触发 回 退 ， 不 处 理 相应 的 请 求 。 在 下 面 的 


ThreadIsol 


atedDemo.java 里 ， 我 们 将 讲解 线程 池 级 别 的 隔离 保护 措施 。 


1 “// 省 略 必要 的 package 和 import 代码 


public class ThreadIsolatedDemo extends HystrixCommand<String> { 


Private String name; 

public ThreadIsolatedDemo (String name) { 
super (Setter.withGroupKey (HystrixCommandGroupKey .Factory. 
asKey ("ThreadIsolatedDemo")) .andThreadPoolKey 
(HystrixThreadPoolKey.Factory.asKey ("ThreadGroup") ) ); 
this.name = name; 

} 

Protected String run() throws Exception { 
System.out .Println("In Run Name is: " + name); 
return name; 

和 

Protected String getFallback() { 
System.out .Println("In GetFallBack, name is:" + name) 
return name; 


} 
// 主 函数 
Public static void main(String[] args) { 
// 不 开启 断路 器 ConfigurationManager.getConfigInstance () .setProperty 
("hystrix.command.default .circuitBreaker.forceOpen", "false"); 
// 配置 最 大 线程 数 是 2 
ConfigurationManager.getConfigInstance () .setProperty( 
"hystrix.threadpool .default .coreSize", 2); 
// 创 建 3 个 线程 ， 开 启 第 3 个 线程 时 报错 
for(int ind = 1; ind <= 3; ind++) { 
ThreadIsolatedDemo demo = new ThreadIsolatedDemo 
(Integer.valueOf (ind) .toString() ) 
demo .queue () 7 


在 构造 函数 的 第 4 行 里 ， 我 们 设置 了 线程 组 ThreadGroup， 在 这 个 案例 中 ， 我 们 设置 了 线程 组 
里 最 大 线程 数 是 2， 所 以 如 果 该 线程 组 里 的 请 求 数量 超过 2， 即 会 开启 断路 器 。 如 果 这 里 我 们 没有 
设置 线程 组 名 ， 而 是 只 设置 了 命令 组 名 ， 就 会 统计 当前 命令 组 里 的 线程 数 ， 超 过 则 熔断 。 

在 main 函数 的 第 18 行 里 ， 我 们 故意 设置 了 断路 器 是 “关闭 ”， 在 第 20 行 里 ， 设 置 了 在 当前 
线程 组 内 最 大 线程 数 是 2， 如果 没有 设置 线程 组 名 就 在 当前 命令 组 中 统计 最 大 线程 数 。 之 后 通过 从 


第 23 行 开始 的 for 循环 创建 了 3 个 请 求 ， 在 调用 第 3 个 请 求 时 ， 由 于 线程 数 超标 ， 因 此 会 进入 


互 


退 模式 ， 调 用 getFallback 方法 ， 输 出 “In GetFallBack, name is:3”。 
由 于 在 Web 应 用 里 常规 的 做 法 是 用 一 个 线程 处 理 一 个 请 求 ， 因 此 相 比 “ 信 号 量 隔离 机 制 ”， 
基于 线程 组 的 隔离 保护 措施 用 得 更 多 一 些 。 
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5.3.5 ”信号 量 级 别 的 隔离 机 制 


相 比 于 线程 级 别 的 隔离 机 制 ， 信 号 量 级 别 的 隔离 机 制 无 须 线程 间 的 切换 ， 所 以 需要 的 系统 资 
源 相 对 少 一 些 ， 但 由 于 不 支持 异步 处 理 和 请 求 超时 异常 ， 因 此 这 种 隔离 机 制 的 应 用 场景 比较 少 。 
在 下 面 的 SemaphoreIsolatedDemo.java 里 ， 我 们 将 演示 基于 信号 量 隔离 机 制 的 实现 方式 。 


1 // 省 略 必要 的 package 和 import 代码 

2 public class SemaphoreIsolatedDemo extends HystrixCommand<String> { 
加 Private String name; 

4 Public SemaphoreIsolatedDemo (String name) { 

1 super (Setter.withGrouPKey(HystrixCommandGrouPKey.Factory 
6 .asKey ("ThreadIsolatedDemo")) ); 

也 this .name = name; 

8 和 

9 Protected String run() throws Exception { 

10 System.out .Println("In Run Name is: " + name); 

return name; 

这 } 

3 Protected String getFallback() { 

14 System.out.println("In GetFallBack, name is:" + name); 
5 return name; 

16 } 

17 // 上 述 代码 和 基于 线程 实现 隔离 机 制 的 ThreadIsolatedDemo .java 是 一 致 的 

18 Public static void main (String[] args) { 

19 // 不 开启 断路 器 

20 ConfigurationManager.getConfigInstance () .setProperty 


("hystrix.command.default .circuitBreaker.forceOpen", "false"); 

21 // 设 置 隔离 策略 是 信号 量 

2 ConfigurationManager.getConfigInstance () .setProperty ("hystrix. 
command.default .execution.isolation.strategy", 
ExecutionIsolationStrategy .SEMAPHORE); 

28 // 设置 信号 量 的 最 大 并 发 数 是 2 

24 ConfigurationManager.getConfigInstance () .setProperty( 
"hystrix.command.default .execution.isolation.semaphore. 
maxConcurrentRequests",2); 


25 呈 /以 // 不 能 用 异步 的 方式 调用 

26 A for(int ind = 1; ind <= 3; ind++) { 

2 SemaphoreIsolatedDemo demo = new SemaphoreIsolatedDemo 
(Integer .valueOf (ind) .toString()) 7 

4 demo .queue () 7 

297 /A } 

30 // 开 启 4 个 线程 同时 调用 

久生 for (int ind = 1; ind < 5; ind++) { 

3 new Caller (Integer.valueOf (ind) .toSstring()).start(); 

33 } 

34 } 

35 


在 main 函数 的 第 20 行 里 , 我 们 同样 关闭 了 断路 器 ; 在 第 22 行 里 , 设置 隔离 策略 是 “信号 量 ”; 
在 第 24 行 里 ， 设 置 最 大 并 发 数量 是 2。 

由 于 基于 信号 量 的 隔离 机 制 不 支持 异步 ， 因 此 不 能 用 类 似 于 第 28 行 的 用 queue 的 方式 调用 ， 
只 能 用 类 似 于 第 32 行 的 启动 多 线程 的 方式 来 模拟 多 个 请 求 同 时 到 达 。 其 中 ，Caller 类 定义 如 下 : 
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36 class Caller extends Thread{ 


37 String name; 

38 public caller(String name) // 构 造 函 数 

39 { this.name = name; } 

40 public void run(){ 

41 SemaphoreIsolatedDemo c = new SemaphoreIsolatedDemo (name); 
42 c.execute(); 

43 } 

44 } 


本 代码 的 运行 结果 如 下 ， 可 能 每 次 运行 结果 都 不 相同 ， 但 每 次 都 能 看 到 有 两 个 请 求 成 功 运行 ， 
另外 两 个 由 于 信和 号 量 已 满 ， 所 以 触发 getFallBack 这 个 回 退 动作 。 


二 In GetFallBack, name is:1 
和 In GetFallBack, name is:3 
3 In Run Name is: 2 
4 In Run Name is: 4 


在 项 目 中 ， 如 果 确 信 该 服务 一 定 不 会 出 现 超时 或 其 他 异常 ， 而 且 无 须 支持 异步 ， 那 么 可 以 用 
基于 信号 量 的 隔离 机 制 来 保护 该 服务 不 会 被 过 载 地 调用 。 但 这 种 场景 并 不 多 见 , 所 以 这 种 隔离 机 制 
一 般 不 常见 


5.3.6 ”通过 合并 批量 处 理 URL 请 求 


哪怕 一 个 URL 请 求 调用 的 功能 再 简单 ，Web 应 用 服务 都 至 少 会 开启 一 个 线程 来 提供 服务 ， 换 
名 话说 ， 有 效 降低 URL 请 求 数 能 很 大 程度 上 降低 系统 的 负载 。 通 过 Hystrix 提供 的 “合并 请 求 ”机 
制 ， 我 们 能 有 效 地 降低 请 求 数量 。 
在 如 下 的 HystrixMergeDemo.java 里 ， 我 们 将 收集 2 秒 内 到 达 的 所 有 “查询 订单 ”的 请 求 ， 并 
把 它们 合并 到 一 个 对 象 中 传输 给 后 台 , 后 台 根 据 多 个 请 求 参数 统一 返回 查询 结果 , 这 种 基于 合并 的 
做 法 将 比 每 次 只 处 理 一 个 请 求 的 方式 要 高 效 得 多 ， 代 码 比 较 长 ， 我 们 按 类 来 说 明 。 
// 省 略 必 要 的 package 和 import 的 代码 
class OrderDetail{ // 订 单 业务 类 ， 其 中 包含 2 个 属性 
Private String orderId; 
Private String orderOwner; 
// 省 略 针对 orderId 和 orderOwner 的 get 和 set 方法 
// 重 写 toString 方法 ， 方 便 输出 
Public String toString() { 
return "orderId: " + orderId + ", orderOwner: " + orderOwner ;} 


o vaoua 必 wm 


9 1 

0 

11 // 合 并 订单 请 求 的 处 理 器 

12 class OrderHystrixCollapser extends HystrixCollapser<Map<String, 
OrderDetail>, OrderDetail, String> 


Sh 

14 String orderId; 

TS // 在 构造 函数 里 传 入 请 求 参 数 

16 Public OrderHystrixCollapser (String orderId) 


17 { this.orderId = orderId;} 
18 ”// 指 定 根据 orderId 去 请 求 orderDetail 
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19 Public String getRequestArgument () 
20 { return orderId;  } 


21 // 创 建 请 求 命令 


22 protected HystrixCommand<Map<String, OrderDetail>> createCommand!( 
23 Collection<CollapsedRequest<OrderDetail, String>> requests) 
24 { return new MergerCommand (requests); } 
25 // 把 请 求 得 到 的 结果 和 请 求 关联 到 一 起 
26 Protected void mapResponseToRequests (Map<String, OrderDetail> 
batchResponse, 
之 了 Collection<CollapsedRequest<OrderDetail, String>> requests) { 
28 for (CollapsedRequest<OrderDetail, String> request : requests) 
29 { 
30 // 请 注意 这 里 是 得 到 单个 请 求 的 结果 
3 OrderDetail oneOrderDetail = 
batchResponse.get (request .getArgument ()); 
32 // 把 结果 关联 到 请 求 中 
3 request .setResponse (oneOrderDetail); 
34 } 
35 } 
汉人 二 


在 第 2 行 中 ， 我 们 定义 了 OrderDetail 类 。 这 里 ， 我 们 将 合并 针对 该 类 对 象 的 请 求 。 

在 第 12 行 中 ， 我 们 定义 了 合并 订单 的 处 理 器 OrderHystrixCollapser 类 ， 它 继承 (extends) 了 
HystrixCollapser<Map<String, OrderDetail>, OrderDetail, String> 类 ， 而 HystrixCollapser 泛 型 中 包含 
了 3 个 参数 : 第 一 个 参数 Map<String, OrderDetail> 表 示 该 合并 处 理 器 合并 请 求 后 返回 的 结果 类 型 ， 
第 二 个 参数 表示 合并 OrderDetail 类 型 的 对 象 ， 第 三 个 参数 表示 根据 String 类 型 的 请 求 参 数 来 合并 
对 象 。 

在 第 19 行 里 ， 我 们 指定 了 是 根据 String 类 型 的 OrderId 参数 来 请 求 OrderDetail 对 象 。 在 第 22 
行 的 createCommand 方法 里 ， 我 们 指定 了 调用 MergerCommand 方法 来 请 求 多 个 OrderDetail。 在 第 
26 行 的 mapResponseToRequests 方法 里 , 我 们 用 第 28 行 的 for 循环 依次 把 batchResponse 对 象 中 包 

含 的 多 个 查询 结果 设置 到 request 对 象 里 ， 由 于 request 是 参数 requests 里 的 元 素 ， 因 此 执行 完 第 28 
行 的 for 循环 后 ，requests 对 象 就 能 关联 到 合并 后 的 查询 结果 。 


37 class MergerCommand extends HystrixCommand<Map<String, OrderDetail>> { 


38 // 用 orderDB 模拟 数据 库 中 的 数据 


39 static HashMap<String, String> orderDB = new HashMap<String,String> (); 

40 static { 

41 orderDB.put ("1","Peter"); 

42 orderDB.put ("2","Tom"); 

43 orderDB.put ("3","Mike"); 

44 } 

45 Collection<CollapsedRequest<OrderDetail, String>> requests; 

46 Public MergerCommand (Collection<CollapsedRequest<OrderDetail, 
String>> requests) { 

47 super (Setter.withGroupKey (HystrixCommandGroupKey.Factory 

48 .asKey ("mergeDemo") ) ) 7 

49 this .requests = requests; 

50 和 

Bi // 在 run 方法 里 根据 请 求 参 数 返 回 结果 

2 Protected Map<String, OrderDetail> run() throws Exception { 


et List<String> orderIds = new ArrayList<String>(); 
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54 // 通 过 for 循环 ， 整 合 参数 

55. for (CollapsedRequest<OrderDetail, String> request : requests) 

56 { orderIds .add (request .getArgument ()); } 

5 // 调用 服务 ,根据 多 个 订单 Td 获得 多 个 订单 对 象 

58 Map<String, OrderDetail> ordersHM = getOrdersFromDB (orderIds) 

33 return ordersHM; 

60 } 

61 // 用 HashMap 模拟 数据 库 ， 从 数据 库 中 获得 对 象 

62 Private Map<String, OrderDetail> getOrdersFromDB (List<String> 
orderIds) { 

63 Map<String, OrderDetail> result = new HashMap<String, 

OrderDetail>(); 

64 for (String orderId : orderIds) { 

65 OrderDetail order = new OrderDetail() 

66 // 这 个 本 该 是 从 数据 库 里 得 到 ， 但 为 了 模拟 ， 仅 从 HashMap 里 取 数 据 

67 order.setorderId (orderId) 

68 order.setOrderOwner (orderDB.get (orderId) ); 

69 result.put (orderId, order); 

70 } 

ya return result; 

72 } 

4 | 


在 MergerCommand 类 的 第 38~44 行 里 ,我 们 用 orderDB 对 象 来 模拟 数据 库 里 存储 的 订单 数据 。 
在 第 46 行 的 构造 函数 里 ， 我 们 用 传 入 的 requests 对 象 来 构建 本 类 里 的 同名 对 象 ， 在 这 个 传 入 的 
requests 对 象 里 ， 已 经 包含 了 合并 后 的 请 求 。 

在 第 52 行 的 run 方法 里 ， 我 们 通过 第 55 行 的 for 循环 ， 依 次 遍历 requests 对 象 ， 并 组 装 包含 
请 求 参数 集合 的 orderlds 对 象 ， 随 后 在 第 58 行 里 ， 通 过 getOrdersFromDB 方法 ， 根 据 List 类 型 的 
orderlds 参数 ， 模 拟 地 从 数据 库 里 读 取 数据 。 


74 public class HystrixMergeDemo{ 


Public static void main(String[] args){ 
76 // 收集 2 秒 内 发 生 的 请 求 ， 合 并 为 一 个 命令 执行 
池子 ConfigurationManager.getConfigInstance () .setProperty( 


"hystrix.collapser.default.timerDelayInMilliseconds"，2000) 
78 // 初始 化 请 求 上 下 文 


了 3 HystrixRequestContext context = 
HystrixRequestContext .initializeContext (); 

80 // 创建 3 个 请 求 合 并 处 理 器 

81 OrderHystrixCollapser collapserl = new 
OrderHystrixCollapser ("1"); 

82 OrderHystrixCollapser collapser2 = new 
OrderHystrixCollapser ("2"); 

83 OrderHystrixCollapser collapser3 = new OrderHystrixCollapser ("3"); 

84 // 异步 执行 

85 Future<OrderDetail> futurel = collapserl.queue(); 

86 Future<OrderDetail> future2 = collapser2.queue(); 

87 Future<OrderDetail> future3 = collapser3.queue(); 

88 Cy 

89 System.out .println (futurel .get ()); 

90 System.out .println (future2.get ()); 

Sm System.out.println (future3.get ()); 


92 } catch (InterruptedException e) { 
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93 e.printStackTrace (); 

94 } catch (ExecutionException e) { 
95 e.printStackTrace (); 

96 } 

97 /关闭 请 求 上 下 文 

98 context .shutdown () 7 

99 } 

100 } 


在 第 74 行 定 义 的 HystrixMergeDemo 类 里 包含 着 main 方法 。 在 第 77 行 里 ， 我 们 设置 了 合并 
请 求 的 窗口 时 间 是 2 秒 。 在 第 81~83 行 ， 创建 了 3 个 合并 处 理 器 对 象 。 在 第 85~87 行 ， 我 们 通过 
queue 方法 以 异步 的 方式 启动 了 3 个 处 理 器 , 并 在 第 89~91 行 里 输出 了 3 个 处 理 器 返回 的 结果 。 这 
个 程序 的 运行 结果 如 下 。 

1 orderId: 1, orderOwner: Peter 

2 orderId: 2, orderOwner: Tom 

2: orderId: 3, orderOwner: Mike 

虽然 在 main 方法 里 ， 我 们 发 起 了 3 次 调用 ， 但 由 于 这 些 调用 是 发 生 在 2 秒 内 的 ， 因 此 会 被 合 
并 处 理 。 下 面 我 们 结合 上 述 针 对 类 和 方法 的 说 明 ， 归 纳 一 下 合并 处 理 3 个 请 求 的 流程 。 

步骤 01 在 代码 的 第 81~83 行 里 ， 通 过 OrderHystrixCollapser 类 型 的 collapserl 等 3 个 对 象 

来 传 入 待 合并 处 理 的 请 求 , OrderHystrixCollapser 类 会 通过 第 16 行 的 构造 函数 分 别 接收 3 个 对 象 传 
入 的 orderld 参数 ， 并 通过 第 22 行 的 createCommand 方法 调用 MergerCommand 类 的 方法 执行 “ 根 
据 订 单 Id 查 订 单 ” 的 业务 。 


由 于 在 OrderHystrixCollapser 内 第 16 行 的 getRequestArgument 方法 里 ， 我 们 指定 了 查询 


参数 名 是 orderld, 因此 createCommand 方法 的 requests 参数 会 用 orderld 来 设置 查询 请 求 ， 
同时 MergerCommand 类 中 的 相关 方法 也 会 用 该 对 象 来 查询 OrderDetail 信息 。 


步 又 024 由 于 在 createCommand 方法 里 调用 了 MergerCommand 类 的 构造 函数 ， 因 此 会 触发 
该 类 第 52 行 的 run 方法 。 在 这 个 方法 里 ， 通 过 第 55~56 行 的 for 循环 ， 把 request 请 求 中 包含 的 多 
个 Argument ( 也 就 是 OrderId ) 放 入 到 orderlds 这 个 List 类 型 的 对 象 中 ， 随 后 通过 第 58 行 的 
getOrdersFromDB 方法 ， 根 据 这些 orderlds 去 找 对 应 的 OrderDetail 对 象 。 

步骤 034 在 getOrdersFromDB 方法 里 ， 找 到 对 应 的 多 个 OrderDetail 对 象 ， 并 组 装 成 
Map<String，OrderDetail> 类 型 的 result 对 象 返 回 ， 然 后 按 调用 链 的 关系 层 层 返回 给 
OrderHystrixCollapser 类 。 

步骤 04 在 OrderHystrixCollapser 类 的 mapResponseToRequests 方法 里 , 通过 for 循环 把 多 次 
请 求 的 结果 组 装 到 requests 对 象 中 。 由 于 requests 对 象 是 Collection<CollapsedRequest<OrderDetail, 
String>> 类 型 的 ， 其 中 用 String 类 型 的 Orderld 关联 到 了 一 个 OrderDetail 对 象 ， 因 此 这 里 会 把 合并 
查询 的 结果 拆散 给 3 次 请 求 ， 具 体 而 言 ， 就 是 会 把 3 个 OrderDetail 对 象 对 应 地 返回 给 第 85~87 行 
通过 queue 调用 的 3 个 请 求 。 
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虽然 通过 合并 请 求 的 处 理 方法 能 降低 URL 请 求 的 数量 ， 但 如 果 合并 后 的 URL 请 求 数 过 


多 , 就 会 撑 爆 掉 合并 处 理 器 (这 里 是 OrderHystrixCollapser 类 ) 的 缓存 。 比 如 在 某 项 目 里 ， 
虽然 只 设置 了 合并 5 秒 内 的 请 求 ， 但 正好 赶 上 秒杀 活动 ， 在 这 个 窗口 期 内 的 请 求 数 过 万 ， 
就 有 可 能 会 出 问题 了 。 


所 以 ， 一 般 会 在 上 线 前 先 通过 测试 确定 合并 处 理 器 的 缓存 容量 ， 随 后 再 预 估 一 下 平均 每 秒 的 
可 能 访问 数 ， 然 后 据 此 设置 合并 的 窗口 时 间 。 


5.4 ”Hystrix 与 Eureka 的 整合 


和 Ribbon 等 组 件 一 样 ， 在 项 目 中 Hystrix 一 般 不 会 单独 出 现 ， 而 是 会 和 Eureka 等 组 件 配套 出 
现 。 

在 Hystrix 和 Eureka 整合 后 的 框架 里 ， 一 般 会 用 到 Hystrix 的 断路 器 以 及 合并 请 求 等 特性 ， 而 
在 Web 框架 里 ， 大 多 会 有 专门 的 缓存 组 件 ， 所 以 不 怎么 会 用 到 Hystrix 的 缓存 特性 。 


5.4.1 准备 Eureka 服务 器 项 目 


代码 \ 第 5 章 \HystrixEurekaServer 视频 \ 第 5 章 \Hystrix 与 Eureka 的 整合 
HystrixEurekaServer 项 目 承 担 着 Eureka 服务 器 的 作用 ， 这 部 分 的 代码 关键 点 如 下 。 
第 一 ， 在 pom.xml 里 ， 通 过 如 下 关键 代码 引入 Eureka 服务 器 组 件 的 依赖 包 。 


和 <dependency> 

最 <groupId>org.springframework.cloud</groupId> 

3 <artifactId>spring-cloud-starter-eureka-server</artifactId> 
4 </dependency> 


第 二 ， 在 application.yml 里 ， 指 定 本 项 目的 主机 名 和 端口 号 ， 并 指定 对 外 提供 Eureka 服务 的 
url 路 径 。 


1 SerVer: 

最 Port: 8888 

3 eureka: 

4 instance: 

5 hostname: localhost 

6 client: 

2 register-with-eureka: false 

8 fetch-registry: false 

9 serviceUrl: 

10 defaultZone: http://localhost:8888/eureka/ 


第 三 ， 在 ServerStarter.java 里 ， 编 写 启动 Eureka 服务 的 代码 。 这 里 请 注意 ， 在 第 2 行 和 第 3 
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行 里 ， 通 过 注解 声明 了 本 类 是 Eureka 服务 器 的 启动 类 。 
// 省 略 必 要 的 package 和 import 的 代码 


@EnableEurekaServer 
@SpringBootApplication 
public class ServerStarter 
{ 
public static void main( String[] args ){ 
SpringApplication.runl(ServerStarter.class, args); 
} 


ownamwmewmnP 


5.4.2 ”服务 提供 者 的 代码 结构 


HystrixEurekaserviceProvider 项 目 承 担 着 Eureka 服务 提供 者 的 角色 。 在 表 5.2 里 ， 我 们 能 看 到 
本 项 目 里 的 目录 结构 。 


表 5.2 ”HystrixEurekaserviceProvider 代码 结构 归纳 表 


文件 名 或 目录 名 描述 

pomxml 
application.yml 
com 


com.controller 控制 器 类 所 在 的 包 


com.service service 层 所 在 的 包 ， 在 控制 器 类 里 会 调用 本 包 内 的 方法 


com.model 存放 着 OrderDetail 这 个 model 类 


在 pom.xml 里 ， 我 们 除了 指定 Eureka 的 依赖 包 以 外 ， 还 指定 了 Hystrix 的 依赖 包 ， 关 键 代码 
如 下 。 其 中 ， 前 4 行 指定 的 是 Eureka 的 依赖 包 ， 后 4 行 指定 的 是 Hystrix 的 依赖 包 。 


1 <dependency> 
2 <groupId>org.springframework.cloud</groupId> 

1 <artifactId>spring-cloud-starter-eureka</artifactId> 
4 </dependency> 

5 <dependency> 
6 
yh 
8 


<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-hystrix</artifactId> 
</dependency> 


在 application.yml 里 ， 指 定 本 项 目的 服务 端口 是 1111、 对 外 提供 的 项 目 名 是 hystrixEureka 以 
及 向 5.4.1 小 节 中 指定 的 Eureka 服务 嚣 注册， 代码 如 下 : 


server: 
ports 上 下 
spring: 
application: 
name: hystrixEureka 
eureka: 
client: 
serviceUrl: 
defaultZone: http://localhost:8888/eureka/ 


» 


ooowN 
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在 服务 提供 者 项 目 里 引入 断路 器 机 制 


在 服务 提供 者 的 启动 类 ServiceProviderApp.java 里 ， 我 们 通过 加 入 @EnableCircuitBreaker 注解 
来 启动 断路 器 ， 代 码 如 下 : 


PPioowamuwmwwnP 


0 


在 Controllerjava 这 个 控制 器 类 里 , 我 们 在 第 9 行 里 , 通过 调用 service 类 提供 的 方法 来 返 


// 省 略 必 要 的 package 和 import 代码 
QSpringBootRAPP1ication 
@EnableEurekaClient 
@EnableCircuitBreaker 
QServletComponentScan 
Public class ServiceProviderApp 
{ 
public static void main( String[] args ){ 
SpringApplication.run(ServiceProviderApp.class, args); 
} 


具 


体 的 OrderDetail 信息 ， 代 码 如 下 。 由 于 这 里 没有 引入 Hystrix， 并 且 在 之 前 的 篇 幅 里 已 经 多 次 讲述 
过 本 类 代码 的 含义 ， 因 此 这 里 不 再 详细 讲述 。 


wawmwewnb 


10 
间谍 


// 省 略 必 要 的 package 和 import 代码 
@RestController 
Public class Controller { 
@Autowired 
Private OrderDetailService service; 
// 对 外 提供 服务 的 getorderDetailById 方 法 
@RequestMapping (value = "/getOrderDetailById/{orderId}", 
method = RequestMethod.GET) 
Public OrderDetail getOrderDetailById(@PathVariable ("orderId") 
String orderId) throws Exception { 
return service.getOrderDetailByID (orderId); 
} 
} 


在 OrderDetailService.java 里 ， 我 们 用 HashMap 这 个 数据 结构 来 模拟 数据 库 ， 以 此 来 模拟 从 数 
据 库 读 OrderDetail 的 方式 ， 提 供 了 “根据 ID 找 相应 对 象 的 服务 ”， 代 码 如 下 : 


// 省 略 必要 的 package 和 import 代码 
@Service 
Public class OrderDetailService { 
static HashMap<String, String> orderDB = new HashMap<String, String> (); 
static // 通 过 static 代码 ， 模 拟 数据 库 中 存储 的 orderDetail 信息 
和 
orderDB.put ("1","Peter"); 
orderDB.put ("2","Tom"); 
orderDB.put ("3","Mike"); 
下 
// 在 方法 之 前 ， 通 过 注解 引入 Bystrix， 并 指定 回 退 方法 
@HystrixCommand (fallbackMethod = "getFallback") 
Public OrderDetail getOrderDetailByID(String id) throws Exception 
. 
OrderDetail orderDetail = new OrderDetail (); 
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16 if("error".equals (id) ) // 如 果 输 入 是 error， 则 故意 抛 出 异常 
thy {throw new Exception(); } 

18 // 模 拟 地 从 数据 库 里 得 到 信息 并 返回 

19 orderDetail.setOrderId(id); 

20 orderDetail.setOrderOwner (orderDB.get (id)); 

要 return orderDetail; 

22 } 

23 // 定 义 Hystrix 的 回 退 方法 

24 public OrderDetail getFallback(String orderId) { 

25 OrderDetail orderDetail = new OrderDetail (); 

26 orderDetail.setOrderId ("error"); 
orderDetail.setOrderOwner ("error"); 

28 System.out.println("In fallbackForOrderDetail function"); 
29 return orderDetail; 

30 } 

310 


在 第 13 行 的 getOrderDetailByID 方法 之 前 , 我 们 在 第 12 行 通过 fallbackMethod 定义 了 回 退 方 
法 ， 在 这 个 方法 的 第 16 行 里 ， 我 们 定义 了 如 果 输 入 是 error 就 抛 出 异常 ， 以 此 触发 回 退 方法 
getFallback。 而 在 第 24 行 定义 的 回 退 方法 里 ， 将 会 返回 一 个 ID 和 Owner 都 是 error 的 OrderDetail 
对 象 。 本 类 用 到 的 OrderDetail 模型 类 定义 如 下 : 
Public class OrderDetaili 


1 

2 private String orderId;// 订 单 id 

3 private String orderOwner; // 订 单 所 有 人 
4 

ES) 


// 省 略 必要 的 get 和 set 方法 


至 此 ， 我 们 完成 了 开发 工作 ， 启 动 HystrixEurekaServer 和 HystrixEurekaserviceProvider 后 ， 如 
果 在 浏览 器 中 输入 “http://localhost:1111/getOrderDetailById/1 ”， 就 能 看 到 如 下 输出 ， 说 明 走 的 是 
正常 的 流程 。 

{"orderId":"1","orderOwner":"Peter"} 

如 果 输 入 的 是 “http:Wlocalhost:1111l/getOrderDetailById/error”， 那 么 会 在 OrderDetailService 
类 的 getOrderDetailByID 方法 里 抛 出 异常 ， 从 而 走 Hystrix 的 回 退 流程 ， 由 此 会 输入 如 下 语句 : 

{"orderId":"error", "orderOwner":"error"} 

在 这 个 案例 中 ， 我 们 是 在 “提供 者 服务 ”的 模块 引入 Hystrix 断路 器 ， 而 不 是 在 “服务 调用 ” 
模块 ， 这 和 项 目 中 的 常规 做 法 相符 ， 因 为 启动 断路 器 的 场景 一 般 是 “提供 服务 模块 的 流量 超载 ”。 


5.4.4 在 服务 调用 者 项 目 里 引入 合并 请 求 机 制 
这 里 我 们 将 在 HystrixEurekaserviceCaller 项 目 里 调用 HystrixEurekaserviceProvider 里 定义 的 服 
务 。 在 调用 时 ， 我 们 将 合并 5 秒 内 发 送 的 请 求 。 


代码 位 置 视频 位 置 
代码 \ 第 5 章 \HystrixEurekaserviceCaller 视频 \ 第 5 章 \ 通 过 Hystrix 合并 请 求 


由 于 之 前 我 们 反复 讲解 过 Eureka 服务 调用 者 的 项 目 代码 结构 ， 因 此 这 里 我 们 给 出 实现 合并 请 
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求 的 关键 步骤 。 
步骤 014 在 控制 器 类 Controllerjava 里 , 初始 化 Hystrix 请 求 上 下 文 , 并 通过 Future 对 象 多 次 
发 送 请 求 ， 代 码 如 下 : 


1 // 省 略 必要 的 package 和 import 代码 

@Configuration 

3  Q@RestController 

4 Public class Controller { 

5 @Autowired 

6 private OrderDetailService service;// 提 供 服务 的 service 类 

// 在 这 个 方法 里 ， 将 演示 合并 请 求 的 效果 

8 @RequestMapping (value = "/mergeDemo", method = RequestMethod .GET) 
9 Public List<OrderDetail> hystrixMergeDemo() throws Exception { 
10 // 初 始 化 Hystrix 请 求 上 下 文 

HystrixRequestContext context = HystrixRequestContext 

12 .initializeContext (); 

13 // 通 过 定义 3 个 Future 对 象 ， 调 用 3 次 请 求 

14 Future<OrderDetail> fl = service.getOneOrderDetail ("1"); 
5 Future<OrderDetail> f2 = service.getOneOrderDetail ("2"); 
16 Future<OrderDetail> f3 = service.getOneOrderDetail ("3"); 
32 OrderDetail ol = fl.get() 7 

18 OrderDetail o2 = f2.get() 7 

19 OrderDetail o3 = f3.get(); 

20 // 把 3 个 返回 对 象 组 装 到 一 个 List 中 并 返回 

tl List<OrderDetail> orderDetailList = new ArrayList<OrderDetail>(); 
22 orderDetailList.add(o1); 

23 orderDetailList.add(o02); 

24 orderDetailList.add(o3) 7? 

25 // 释 放 上 下 文 

26 context .shutdown () 7 

27 return orderDetailList; 

28 1 

| 


在 上 文 的 hystrixMergeDemo 方法 里 ， 我 们 首先 在 第 11 行 初始 化 Hystrix 请 求 上 下 文 ， 随 后 在 
第 14~16 行 调用 了 3 次 getOneOrderDetail 方法 ， 并 在 第 17~19 行 里 通过 Furure 类 型 对 象 的 get 方 
法 把 3 次 调用 的 结果 分 别 赋予 3 个 OrderDetail 类 型 的 对 象 。 之 后 ， 通 过 第 21~24 行 的 代码 ， 把 3 
个 OrderDetail 对 象 组 装 成 一 个 List<OrderDetail> 类 型 的 orderDetailList 对 象 ， 并 在 第 27 行 返 EE 
orderDetailList 对 象 。 

这 里 虽然 是 发 出 了 3 次 调用 请 求 ， 但 从 后 文 的 讲解 里 我 们 能 看 到 这 3 次 请 求 其 实 是 被 合并 处 
理 的 。 由 于 在 合并 请 求 时 ，Hystrix 处 理 类 会 把 请 求 暂 存 在 Hystrix 请 求 上 下 文 里 ， 因 此 我 们 一 定 得 
通过 类 似 于 第 11 行 的 代码 初始 化 上 下 文 ， 和 否则 将 无 法 得 到 合并 请 求 的 结果 。 

步 又 024 之 前 我 们 看 到 , 在 Controller 类 里 是 调用 OrderDetailService 类 的 方法 来 查询 多 个 订 
单 ， 所 以 合并 请 求 的 代码 是 写 在 这 个 类 里 的 ， 我 们 来 看 一 下 代码 。 
// 省 略 必要 的 Package 和 import 代码 
@Component 


public class OrderDetailService { 


// 合并 处 理 收集 5 秒 内 的 请 求 


AODP 


第 5 章 服务 容错 组 件 : HyStrix | 99 


@HystrixCollapser (batchMethod = "getMoreOrderDetails", 
collapserProperties = {@HystrixProperty(name = 
"timerDelayInMilliseconds",value = "5000")}) 

6 public Future<OrderDetail> getOneOrderDetail (String id) { 

| System.out .Println("in getOneOrderDetail"); 

8 return null; 


10 @Bean 

11 @LoadBalanced 

12 Public RestTemplate getRestTemplate() 

13 { return new RestTemplate(); 起 

14 // 这 里 是 合并 请 求 的 代码 

15 @HystrixCommand 

16 Public List<OrderDetail> getMoreOrderDetails(List<String> orderIds) { 

17 System.out.println("in getMoreOrderDetails," + orderIds.size()); 

18 List<OrderDetail> list = new ArrayList<OrderDetail>(); 

19 RestTemplate template = getRestTemplate(); 

20 // 通 过 for 循环 ， 调 用 服务 提供 者 的 方法 得 到 OrderDetail 对 象 

2 for (String orderId : orderIds) { 

ok OrderDetail orderDetail = new OrderDetail (); 

223 orderDetail = template.getForObject( 
"http://localhost:1111/getOrderDetailById/{orderId}", 
OrderDetail.class,orderId); 

24 list.add(orderDetail); 

25 } 

26 return list; 

27 } 

2 


在 第 6~9 行 里 ， 我 们 定义 了 只 查询 一 个 对 象 的 getOneOrderDetail 方法 ， 在 定义 该 方法 的 注解 
里 ， 我 们 指定 了 会 把 在 5 秒 内 调用 该 方法 的 请 求 合并 到 getMoreOrderDetails 方法 里 。 在 第 16~25 
行 的 getMoreOrderDetails 方法 里 , 我 们 通过 第 21~25 行 的 for 循环 依次 遍历 待 查询 的 orderld, 并 通 
过 第 23 行 的 getForObject 方法 调用 服务 提供 者 的 getOrderDetailByld 方法 , 得 到 对 应 的 OrderDetail 
对 象 ， 并 添加 到 List<OrderDetail> 类 型 的 list 对 象 中 。 最 后 ， 通 过 第 26 行 的 代码 返回 包含 多 次 请 求 
结果 的 list 对 象 。 

当 我 们 启动 Eureka 服务 器 (HystrixEurekaServer)、 服 务 提供 者 (HystrixEurekaserviceProvider) 
和 服务 调用 者 (HystrixEurekaserviceCaller) 3 个 项 目 后， 可 以 在 浏览 器 里 输入 如 下 请 求 ， 以 此 来 查 
看 合并 请 求 的 效果 。 


http://localhost:8080/mergeDemo 


上 述 请 求 的 输出 如 下 ， 我 们 能 看 到 3 个 OrderDetail 对 象 。 从 上 述 的 讲解 能 看 出 这 3 个 对 象 其 
实 是 通过 一 次 合并 后 的 请 求 得 到 的 。 

[{"orderId":"1","orderOwner":"Peter"}, {"orderId":"2","orderOwner":"Tom"}, 

{"orderId":"3","orderOwner":"Mike"}] 
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5.5 本 童 小结 


本 章 不 仅 讲述 了 Hystrix 的 语法 ， 还 讲述 了 包含 在 Hystrix 背后 的 各 种 容错 保护 机 制 的 实践 方 
式 ， 而 且 在 讲述 Hystrix 单独 用 法 的 基础 上 还 讲述 了 在 微服 务 体系 中 加 入 Hystrix 保护 机 制 的 做 法 。 

在 之 前 的 章节 里 ， 我 们 可 以 学 到 “高 可 用 ”框架 的 开发 和 配置 方式 。 在 这 里 ， 大 家 能 进一步 
站 在 架构 师 的 角度 掌握 “加 强 系 统 健壮 性 ”的 实践 方式 , 无 疑 将 让 大 家 在 架构 师 的 晋级 道路 上 迈 出 
更 坚实 的 一 步 。 


第 6 章 


服务 调用 框架 : Feign 


之 前 的 案例 中 , 我 们 是 通过 RestTemplate 来 调用 服务 的 , 而 Feign 框架 则 在 此 基础 上 做 了 一 层 
封装 ， 比 如 可 以 通过 注解 等 方式 来 绑 定 参数 ， 或 者 以 声明 的 方式 指定 请 求 返回 类 型 是 JSON。 

这 种 “再 次 封装 ”能 给 我 们 带 来 的 便利 有 两 点 ， 第 一 ， 开 发 者 无 须 像 使 用 RestTemplate 那样 
过 多 地 关注 HTTP 调用 细节 ; 第 二 ,在 大 多 数 场景 里 ， 某 种 类 型 的 调用 请 求 会 被 在 多 个 地 方 多 次 使 
用 ， 通 过 Feign 能 方便 地 实现 这 类 “重用 ”。 

本 章 将 围绕 实际 项 目的 需求 讲述 Feign 在 项 目 中 的 使 用 要 求 ,比如 Ribbon 和 Hystrix 等 和 Feign 
组 合 使 用 的 方式 ， 所 以 大 家 在 学 完 本 章 后 ， 不 仅 能 知道 概念 ， 还 能 真正 在 项 目 中 学 会 使 用 Feign。 


6.1 通过 案例 快速 上 手 Feign 


这 里 我 们 不 讲 Feign 的 概念 ， 而 是 先 通过 一 个 案例 来 讲述 Feign 的 开发 方式 ， 大 家 能 从 中 对 比 
地 看 到 Feign 调用 和 基于 RestTemplate 调用 的 差异 ， 由 此 直观 地 感受 到 Feign 组 件 的 便利 性 。 

在 这 个 案例 中 ， 我 们 将 用 Eureka 组 件 来 开发 服务 注册 项 目 和 服务 提供 项 目 ， 由 于 这 部 分 的 知 
识 点 在 前 文中 已 经 讲 过 , 因此 这 里 我 们 只 给 出 关键 性 的 配置 , 具体 的 细节 大 家 可 以 参照 本 书 附带 的 
代码 。 


6.1.1 编写 服务 注册 项 目 和 服务 提供 项 目 


本 小 节 将 搭建 一 个 基于 Eureka 的 服务 器 和 一 个 服务 提供 者 ， 以 便 后 继 的 Feign 客户 端 调 用 。 
在 FeignDemo-Server 项 目 里 ， 搭 建 基于 Eureka 的 服务 器 ， 其 代码 和 视频 位 置 如 下 。 
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代码 位 置 视频 位 置 
代码 \ 第 6 章 \FeignDemo-Server 视频 \ 第 6 章 \Feign 案例 演示 《〈 服 务 注册 ) 


该 项 目的 端口 号 是 8888， 主 机 名 是 localhost， 启 动 后 ， 能 通过 http://localhost:8888/eureka/ 查 看 
注册 到 Eureka 服务 器 中 的 诸多 服务 提供 者 或 调用 者 的 信息 。 

在 FeignDemo-ServiceProvider 项 目的 控制 器 类 里 ， 我 们 提供 了 一 个 sayHello 方法 ， 有 具体 代码 
和 视频 位 置 如 下 。 


代码 位 置 视频 位 置 
代码 \ 第 6 章 \FeignDemo-ServiceProvider 视频 \ 第 6 章 \Feign 案例 演示 《服务 提供 ) 


本 项 目 提 供 服务 的 端口 号 是 1111， 对 外 提供 的 application name 服务 名 ) 是 sayHelloServiceProvider， 
是 向 FeignDemo-Server 服务 器 (也 是 Eureka 服务 器 ) 的 http://localhost:8888/ eureka/ 注 册 服 务 。 
而 提供 sayHello 的 方法 如 下 ， 我 们 能 从 中 看 到 对 应 的 RequestMapping 值 。 


出 @RequestMapping (value = "/hello/{username}", method = 
RequestMethod.GET ) 

Public String sayHello(@PathVariable ("username") String username){ 

3 return "hello " + username; 

一 


6.1.2 ”通过 Feign 调用 服务 


这 里 我 们 将 在 FeignDemo-ServiceCaller 项 目 里 演示 通过 Feign 调用 服务 的 方式 。 


代码 位 置 视频 位 置 


代码 \ 第 6 章 \FeignDemo-ServiceCaller 视频 \ 第 6 章 \Feign 案例 演示 〔 服 务 调用 ) 
步骤 014 在 pom.xml 中 引入 Eureka、Ribbon 和 Feign 的 相关 包 ， 关 键 代码 如 下 。 


其 中 ,通过 第 1~9 行 代码 引 入 Eureka 包 ， 通 过 第 10~13 行 代码 引入 Ribbon 包 ， 通 过 第 14~17 
行 代码 引入 Feign 包 。 


1 <dependency> 
和 <groupId>org.springframework.boot</groupId> 

3 <artifactId>spring-boot-starter-web</artifactId> 

4 <version>1.5.4.RELEASE</version> 

5 </dependency> 

6 <dependency> 

<groupId>org.springframework.cloud</groupId> 

8 <artifactId>spring-cloud-starter-eureka</artifactId> 
9 </dependency> 

10 <dependency> 

hh <groupId>org.springframework.cloud</groupId> 

2 <artifactId>spring-cloud-starter-ribbon</artifactId> 
13 </dependency> 

14 <dependency> 

15 <groupId>org.springframework.cloud</groupId> 

16 <artifactId>spring-cloud-starter-feign</artifactId> 
17 </dependency> 


第 6 章 服务 调用 框架 : Feign | 103 


步 聂 024 在 application.yml 中 , 通过 第 3 行 代 码 定义 本 项 目的 名 字 叫 callHelloByFeign, 通过 
第 5 行 代码 指定 本 项 目 工作 在 8080 端口 。 同 时 通过 第 9 行 代 码 指定 本 项 目 是 向 
http:Wlocalhost:8888/eureka/ ( 也 就 是 FeignDemo-Server ) 这 个 Eureka 服务 器 注册 的 。 


ownamwmewmnP 


spring: 
application: 
name: callHelloByFeign 
server: 
port: 8080 
eureka: 
client: 
serviceUrl: 


defaultZone: http://localhost:8888/eureka/ 


步骤 034 在 启动 类 中 ， 通 过 第 1 行 代码 添加 支持 Feign 的 注释 ， 关键 代码 如 下 。 这 样 ， 在 启 
动 这 个 Eureka 客户 端 时 ， 就 可 以 引入 Feign 支持 。 


OAMAMAODNDp 


@EnableFeignClients 
@EnableDiscoveryClient 
@SpringBootApplication 
Public class ServiceCallerApp 
{ 
public static void main( String[] args ) 
{ SpringApplication.run(ServiceCallerApp.class, args); } 
} 


步骤 044 通过 Feign 封装 客户 端 调用 的 细节 ， 外 部 模块 是 通过 Feign 来 调用 客户 端的 ， 这 部 
分 代码 在 Controllerjava 中 。 


16 
和 
18 
19 
20 


/ /省略 必要 的 package 和 import 的 代码 
// 通 过 注解 指定 待 调用 的 服务 名 
@FeignClient ("sayHelloServiceProvider") 
// 在 这 个 接口 里 ， 通 过 Feign 封装 客户 端的 调用 细节 
interface FeignClientTool 
{ 
@RequestMapping (method = RequestMethod.GET, value = 
"/hello/ {name}") 
String sayHelloInClient (@PathVariable ("name") String name); 


' 

//Controller 是 控制 器 类 

@RestController 

Public class Controller { 

@Autowired 
private FeignClientTool tool; 

// 在 callHello 方法 中 ， 是 通过 Feign 来 调用 服务 的 
@RequestMapping (value = "/callHello", method = RequestMethod.GET) 
Public String callHello(){ 

return tool.sayHelloInClient ("Peter"); 
} 
} 


在 Controller.java 文件 中 定义 了 一 个 接口 和 一 个 类 。 在 第 5 行 的 FeignClientTool 接口 中 , 我 们 
封装 了 Feign 的 调用 业务 ， 具 体 来 说 ， 是 通过 第 3 行 的 FeignClient 注解 指定 该 接口 会 调用 
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“sayHelloServiceProvider ”服务 提供 者 的 服务 ， 而 通过 第 8 行 指定 调用 该 服务 提供 者 中 
sayHelloInClient 的 方法 。 
在 第 12~20 行 的 Controller 类 中 , 先是 在 第 14 行 中 通过 Autowired 注解 引入 了 FeignClientTool 
类 型 的 tool 类 ， 随 后 在 第 17 行 的 callHello 方法 中 通过 tool 类 的 sayHelloInClient 方法 调用 了 服务 
提供 者 的 相关 方法 。 
也 就 是 说 ， 在 callHello 方法 中 ， 我 们 并 没有 通过 RestTemplate 以 输入 地 址 和 服务 名 的 方式 调 
用 服务 ， 而 是 通过 封装 在 FeignClientTool (Feign 接口 ) 中 的 方法 调用 服务 。 
完成 上 述 代码 后 ， 我 们 可 以 通过 如 下 步骤 查看 运行 效果 。 
步骤 01 启动 FeignDemo-Server 项 目 ,随后 输入 “http:/Wlocalhost:8888/”, 能 看 到 注册 到 Eureka 
服务 器 中 的 诸多 服务 。 
步 又 024 启动 FeignDemo-ServiceProvider 项 目 ， 随 后 输入 “http://localhost:1111/hello/Peter”， 
能 调用 其 中 的 服务 ， 此 时 能 在 浏览 器 中 看 到 “hello Peter” 的 输出 。 
步骤 03 启动 FeignDemo-ServiceCaller 项 目 ， 随 后 输入 “http://localhost:8080/callHello”"， 同 
样 能 在 浏览 器 中 看 到 “hello Peter” 的 输出 。 请 注意 ， 这 里 的 调用 是 通过 Feign 完成 的 。 


6.1.3 ”通过 比较 其 他 调用 方式 来 了 解 Feign 的 封装 性 


在 之 前 的 代码 中 ， 我 们 是 使 用 如 下 形式 通过 RestTemplate 对 象 来 调用 服务 的 。 

1 RestTemplate template = getRestTemplate(); 

2 String retVal = template.getForEntity("http://sayHello/hello/ 

Eureka", String.class) .getBody(); 

在 第 2 行 的 调用 中 ， 我 们 需要 指定 url 以 及 返回 类 型 等 信息 。 

之 前 我 们 还 见 过 基于 RestClient 对 象 的 调用 方式 ， 关 键 代 码 如 下 。 

1 RestClient client = (RestClient)ClientFactory. 

getNamedClient ("RibbonDemo"); 
2 HttpRequest request = HttpRequest.newBuilder() .uri(new URI("/hello")). 
build(); 

3 HttpResponse response = client.executeWithLoadBalancer (request); 

其 中 , 在 第 1 行 指定 发 起 调用 的 RestClient 类 型 的 对 象 ， 在 第 2 行 指定 待 调用 的 目标 地 址 ， 随 
后 在 第 3 行 发 起 调用 。 

这 两 种 调用 方式 的 共同 点 : 调用 时 ， 需 要 详细 地 知道 各 种 调用 参数 ， 比 如 服务 提供 者 的 url， 
如 果 有 需要 通过 Ribbon 实现 负载 均衡 等 机 制 ， 也 需要 在 调用 时 一 并 指定 。 

但 事实 上 ， 这 些 调用 方式 的 底层 细节 应 该 向 服务 使 用 者 屏蔽 ， 比 如 在 调用 时 无 须 关注 目标 url 
等 信息 。 这 就 好 比 某 位 老板 要 秘书 去 订 飞 机 票 ， 作 为 服务 使 用 者 的 老板 只 应 当 关 心 调 用 的 结果 ， 比 
如 买 到 的 飞机 票 是 几 点 开 的 , 该 去 哪个 航 站 楼 登 机 ， 至 于 调用 服务 的 底层 细节 ， 比 如 该 到 哪个 订 票 
网 站 去 买 ， 服 务 使 用 者 无 须知 道 。 

说 得 更 专业 些 ， 这 叫 “ 解 契合 ”， 即 降低 服务 调动 者 和 服务 提供 者 之 间 的 厢 合 度 。 这 样 的 好 处 是 ， 
一 旦 服务 提供 者 改变 了 实现 细节 〈 没 改变 服务 调用 接口 ) ， 那 么 服务 调用 者 部 分 的 代码 无 须 改动 。 

我 们 再 来 回顾 一 下 通过 Feign 调用 服务 的 方式 。 
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1 private FeignClientTool tool; // 定 义 Feign 类 
2 tool.sayHelloInClient ("Peter"); // 直 接 调 用 


第 2 行 是 调用 服务 ， 但 其 中 ， 我 们 看 不 到 任何 服务 提供 者 的 细节 ， 因 为 这 些 都 在 第 1 行 引用 
的 FeignClientTool 类 中 封装 掉 了 。 也 就 是 说 , 通过 基于 Feign 的 调用 方式 , 开发 者 能 真正 地 做 到 “ 面 
向 业务 ”， 而 无 须 过 多 地 关注 发 起 调用 的 细节 。 


6.2 ”Feign 的 常见 使 用 方式 


在 上 文 的 案例 中 , 我 们 演示 了 通过 Feign 传递 参数 和 返回 结果 的 做 法 。 在 本 节 ， 我 们 将 在 此 基 
础 上 讲述 Feign 在 实际 项 目 中 的 其 他 常见 用 法 ， 从 而 能 让 大 家 掌握 Feign 在 项 目 中 的 常见 用 法 。 


6.2.1 ”通过 继承 改善 项 目 架构 


我 们 经 常 在 方法 中 返回 自 定义 的 业务 对 象 ， 比 如 在 如 下 方法 中 返回 的 是 自 定义 的 订单 类 。 

1 public Order getOrder() { 省 略 业务 方法 } 

这 里 存在 一 个 问题 : 在 提供 服务 和 调用 服务 的 项 目 中 ， 我 们 不 得 不 多 次 定义 这 类 业务 类 ， 所 
以 会 有 “同一 段 代 码 多 次 出 现 ” 的 “代码 重复 ”问题 ， 这 对 项 目的 可 维护 性 非常 不 利 ， 比 如 需要 修 
改 某 个 业务 类 中 的 字段 ， 那 么 我 们 不 得 不 在 多 个 类 中 多 次 修改 ， 万 一 有 地 方 漏 改 了 ， 就 会 出 问题 。 

针对 这 类 问题 ， 我 们 可 以 通过 “继承 ”特性 优化 代码 结构 ， 有 具体 的 实现 步骤 如 下 。 


代码 \ 第 6 章 \FeignBaseProj 


代码 \ 第 6 章 \FeignDemo-Server 视频 \ 第 6 章 \ 通 过 Feign 改善 代码 架构 
代码 \ 第 6 章 \FeignDemo-ServiceProvider 
代码 \ 第 6 章 \FeignDemo-ServiceCaller 


步骤 014 新 建 一 个 通用 的 项 目 FeignBaseProj, 在 其 中 定义 服务 提供 者 和 调用 者 都 会 用 到 的 业 
务 类 Orderjava， 代 码 如 下 。 


1 public class Order { 

2 private String orderID; // 订 单 ID 

3 private int amount; // 订 单 金额 

4 private String owner; // 订 单 拥 有 者 
5 // 省 上 略 必要 的 get 和 set 方法 

,| 


同时 ， 在 FeignBaseProj 项 目 中 ， 定 义 一 个 封装 服务 方法 的 接口 OrderServerInterface。 


1 public interface OrderServiceInterface { 

@RequestMapping (value="getOrder",method=RequestMethod.GET) 
3 Order getOrderByID (@RequestHeader ("id") String id); 

a 
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在 第 3 行 ， 我 们 定义 了 一 个 根据 id 查找 订单 的 getOrderByID 方法 ， 该 方法 在 服务 提供 者 和 服 
务 调用 者 的 项 目 中 均 会 被 用 到 。 在 第 2 行 中 ,我 们 通过 @RequestMapping 定义 了 该 方法 的 调用 路 径 ， 
同时 ， 在 第 3 行 通过 @RequestHeader 注解 指定 了 该 方法 需要 绑 定 id 这 个 参数 。 


步骤 024 改写 FeignDemo-ServiceProvider 项 目的 pom 文件 ， 在 其 中 添加 引入 FeignBaseProj 
包 的 代码 。 
<dependency> 
<groupId>com.springboot</groupId> 
<artifactId>FeignBaseProj</artifactId> 


<version>0.0.1-SNAPSHOT</version> 
</dependency> 


名 
加 
4 
5 
通过 上 述 代 码 ，FeignDemo-ServiceProvider 项 目 就 能 使 用 FeignBaseProj 项 目 中 定义 的 Order 
业务 类 和 包含 订单 服务 方法 的 OrderServiceInterface 接口 了 。 
同时 ， 在 这 个 项 目 中 ， 定 义 另 一 个 提供 订单 服务 的 控制 器 类 OrderControllerjava， 代 码 如 下 。 
// 省 略 必 要 的 Package 和 import 方法 
Q@RestController // 说 明 这 个 类 是 控制 器 类 


号 
2 
3 public class OrderController implements OrderServiceInterface { 
4 // 实 现 具体 的 方法 
5 Public Order getOrderByID(String id) { 
6 Order order = new Order(); 
7 order.setOrderID (id); 

8 order.setAmount (100); 

9 order.setOwner ("Tom"); 

10 return order; 


E20 
在 第 5 行 中 ,我 们 实现 了 有 具体 的 根据 id 查 订单 的 方法 .这 里 ,我 们 看 不 到 类 似 @RequestMapping 
的 注解 ， 也 就 是 说 ,我 们 已 经 在 接口 中 定义 了 服务 路 径 和 服务 绑 定 参 数 等 的 信息 ， 只 需要 定义 业务 
动作 即 可 。 
步 又 034 在 使 用 服务 的 FeignDemo-ServiceCaller 项 目 中 ， 同 样 在 pomxml 中 引入 
FeignBaseProj 项 目 ， 具 体 代 码 和 步骤 步骤 024 中 的 一 致 。 


此 外 ， 再 定义 一 个 Feign 客户 端的 接口 FeignInterface.java， 代 码 如 下 。 
// 省 略 必要 的 package 和 import 代码 


2 FeignClient (value="sayHelloServiceProvider") 
3 public interface FeignInterface extends OrderServiceInterface 
1 

在 第 2 行 中 , 我 们 通过 @FeignClient 的 value 值 指 定 了 待 调 用 服务 的 名 字 (applicationName) ， 
这 需要 和 FeignDemo-ServiceProvider 项 目 中 application.yml 中 的 application.name 值 一 致 。 

通过 第 3 行 代码 ,我 们 能 看 到 该 接口 继承 了 FeignBaseProj 项 目 中 的 OrderServiceInterface 接口 ， 
所 以 在 这 个 Feign 客户 端 中 ， 能 用 到 OrderServiceInterface 中 的 getOrderByID 方法 。 

随后 ， 在 这 个 项 目 中 重新 定义 一 个 控制 器 类 ControllerForFeign.java。 在 其 中 通过 Feign 客户 端 
对 象 调用 getOrderByID 服务 ， 代 码 如 下 。 
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// 省 略 必 要 的 package 和 import 代码 
8@RestController // 这 也 是 一 个 控制 器 类 
Public class ControllerForFeign { 
@Autowired 
Private FeignInterface feignTool; 
@RequestMapping (value = "/getOrder", method = RequestMethod.GET) 
Public Order getOrder() 
{ return feignTool .getOrderByID("101");} 
在 第 5 行 中 , 我们 通过 @Autowired 注解 引入 了 Feign 客户 端的 接口 feignTool 对 象 , 在 第 7 行 
的 getOrder 方法 中 用 feignTool 对 象 调用 了 getOrderByID 服务 。 
至 此 ， 我 们 完成 了 代码 的 编写 。 随 后 可 以 通过 如 下 步骤 来 查看 运行 结果 。 
步骤 01 启动 FeignDemo-Server 和 FeignDemo-ServiceProvider 项 目 ， 随 后 在 浏览 器 中 输入 
“http://localhost:1111/getOrder”"， 能 看 到 有 和 输出 结果 。 输 出 结果 是 :“ {"orderID":null,"amount":100， 
"owner":"Tom"}"。 
步骤 024 启动 FeignDemo-ServiceCaller 项 目 ， 随 后 输入 “http://localhost:8080/getOrder"， 能 
看 到 相同 的 输出 结果 。 


从 输出 结果 上 来 看 ， 和 6.1 节 很 相似 , 但 从 代码 结构 上 来 看 ， 由 于 我 们 把 通用 性 的 业务 类 和 接 
口 定义 到 了 FeignBaseProj 项 目 中 ， 在 相关 类 中 只 是 引用 ， 而 不 是 多 次 重复 定义 。 

而 且 ， 在 封装 Feign 客户 端的 FeignInterface 接口 中 ， 只 是 继承 了 FeignBaseProj 中 相关 提供 服 
务 的 接口 ， 也 不 是 重复 定义 。 

所 以 ， 在 本 节 通 过 “继承 ”实现 的 案例 具有 较 高 的 维护 性 。 况 且 ， 在 本 节 中 ， 只 有 一 处 需要 调用 服 
务 ， 如 果 在 其 他 项 目 中 ， 同 一 个 服务 会 被 调用 多 次 ， 那 么 这 种 可 维护 性 给 我 们 带 来 的 便利 将 更 加 明显 。 


ownamumewn 


6.2.2 ”通过 注解 输出 调用 日 志 


在 开发 和 调试 阶段 , 我 们 希望 能 看 到 日 志 , 从 而 能 定位 和 排查 问题 。 这 里 , 我 们 将 讲述 在 Feign 
中 输出 日 志 的 方法 ， 以 便 大 家 在 通过 Feign 调用 服务 时 能 看 到 具体 的 服务 信息 。 

这 里 我 们 将 改写 FeignDemo-ServiceCaller 项 目 。 

改动 点 1: 在 application.yml 文件 中 增加 如 下 代码 ， 以 开启 Feign 客户 端的 DEBUG 日 志 模 式 。 
请 注意 ， 这 里 需要 指定 完成 的 路 径 ， 就 像 第 3 行 那样 。 


i logging: 
2 level: 
3 com.controller.FeignClientTool: DEBUG 


改动 点 2: 在 这 个 项 目的 启动 类 ServiceCallerApp.java 中 增加 定义 日 志 级 别 的 代码 。 在 第 7~9 
行 的 feignLoggerLevel 方法 中 ， 我 们 通过 第 8 行 代 码 指定 Feign 日 志 级 别 是 FULL。 


// 省 略 必 要 的 pacakge 和 import 代码 
QEnableFeignClients 
@EnableDiscoveryClient 
@SpringBootApplication 

Public class ServiceCallerApp{ 
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@Bean // 定 义 日 志 级 别 是 FULL 
Level feignLoggerLevel () { 
return Level .FULL; 


} 
// 启 动 类 
public static void main( String[] args ) { 
SpringApplication.run(ServiceCallerApp.class, args); 
3} 
} 


完成 后 ， 依 次 运行 Eureka 服务 器 、 服 务 提供 者 和 服务 调用 者 的 启动 类 ， 随 后 在 浏览 器 中 输入 
“http;//localhost:8080/callHello”， 即 可 在 控制 台中 看 到 DEBUG 级 别 的 日 志 。 下 面 给 出 了 部 分 输出 。 


时 


从 第 


2018-06-17 12:18:27.296 DEBUG 208 --- [rviceProvider-2] 
com.controller.FeignClientTool : [FeignClientTool#sayHelloInClient] 
---> GET http://sayHelloServiceProvider/hello/Peter?name=Peter HTTP/1.1 

2018-06-17 12:18:27.296 DEBUG 208 --- [rviceProvider-2] 


com.controller.FeignClientTool : [FeignClientTool#sayHelloInClient] 
---> END HTTP (0-byte body) 


1 行 的 输出 中 ,我 们 能 看 到 以 GET 的 方式 向 FeignClientTool 类 的 sayHelloInClient 方法 发 


起 调用 ， 从 第 2 行 的 输出 中 ， 能 看 到 调用 结束 。 


在 上 


文中 ， 我 们 用 的 是 FULL 级 别 的 日 志 ， 此 外 ， 还 有 NONE、BASIC 和 HEADERS 三 种 。 


在 表 6.1 中 ， 我 们 将 详细 讲述 各 级 别 日 志 的 输出 情况 。 
表 6.1 Feign 各 级 别 日 志 的 输出 情况 


日 志 输出 级 别 
不 输出 任何 日 志 


只 输出 请 求 的 方法 、 请 求 的 URL 和 相应 的 状态 码 ， 以 及 执行 的 时 间 
除了 会 输出 BASIC 级 别 的 日 志 外 ， 还 会 记录 请 求 和 响应 的 头 信息 


输出 所 有 的 与 请 求 和 响应 相关 的 日 志 信息 
一 般 情况 下 , 在 调试 阶段 可 以 把 日 志 级 别 设置 成 FULL, 等 上 线 后 , 可 以 把 级 别 调整 为 BASIC， 
因为 ， 在 生产 环境 上 过 多 的 日 志 反而 会 降低 排查 和 定位 问题 的 效率 。 


6:2:3 


在 网 


压缩 请 求 和 返回 以 提升 访问 效率 


络 传输 过 程 中 ， 如 果 我 们 能 降低 传输 流量 ， 那 么 可 以 提升 处 理 请 求 的 效率 。 尤 其 在 一 些 


日 常 访问 量 比较 高 的 网 络 应 用 中 ， 如 果 能 降低 处 理 请 求 (Request) 和 发 送 返回 信息 〈Response) 
的 时 间 ， 就 能 提升 本 站 的 吞吐 量 。 
在 Feign 中 ， 我 们 一 般 能 通过 如 下 配置 来 压缩 请 求 和 响应 。 


第 一 ， 


下 
2 
总 
4 
5 


可 以 通过 在 application.yml 中 增加 如 下 配置 来 压缩 请 求 和 返回 信息 。 


feign: 
compression: 
request: 
enabled: true 
feign: 
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6 Compression: 
oh response: 
8 enabled: true 


其 中 ， 前 4 行 是 压缩 请 求 ， 而 后 4 行 是 压缩 返回 。 

第 二 ， 可 以 通过 如 下 代码 设置 哪 类 请 求 〈 或 返回 ) 将 被 压缩 。 这 里 我 们 在 第 4 行 中 指定 了 两 
类 格式 的 请 求 将 被 压缩 。 

feign: 

2 compression: 

3 request: 

4 mime-types: text/xml,application/xml 

第 三 ， 可 以 通过 如 下 代码 指定 待 压缩 请 求 的 最 小 值 ， 这 里 是 2048。 也 就 是 说 ， 超 过 这 个 值 的 
request 才 会 被 压缩 。 

yb feign: 

和 compression: 

总 request: 

4 min-request-size: 2048 


6.3 通过 Feign 使 用 Ribbon 负载 均衡 特性 


根据 上 文 的 学 习 , 我 们 知道 通过 Feign 可 以 封装 服务 调用 端的 代码 , 而 第 4 章 提 到 的 基于 Ribbon 
的 负载 均衡 机 制 ， 一 般 也 是 部 署 在 服务 调用 端 ， 所 以 在 实际 的 项 目 中 ， 我 们 往往 会 整合 使 用 Feign 
和 Ribbon 两 个 组 件 。 

这 样 做 的 好 处 是 ， 能 通过 Feign“ 封 装 ” 特 性 向 业务 开发 者 屏蔽 掉 “负载 均衡 ”的 实现 细节 ， 
从 而 让 业务 代码 能 更 关注 于 “业务 功能 逻辑 ”， 而 无 须 考虑 所 需 服务 的 调用 方式 。 


6.3.1 准备 Eureka 服务 器 以 及 多 个 服务 提供 者 


这 里 ， 我 们 将 重用 4.4.6 小 节 提 供 的 两 个 〈 即 主 从 ) Eureka 服务 项 目 以 及 三 个 服务 提供 者 的 项 
目 。 随 后 在 此 基础 上 ， 在 服务 调用 者 的 项 目 中 ， 通 过 Feign 以 负载 均衡 的 方式 调用 三 个 服务 提供 者 
所 提供 的 sayHello 方法 。 具 体 所 用 到 的 项 目 如 表 6.2 所 示 。 


表 6.2 通过 Feign 调用 Ribbon 案例 中 用 到 的 项 目 归 纳 表 


项 目 名 作用 
EurekaRibbonDemo-Server Eureka 服务 器 
Eureka 服务 器 ， 和 另 一 台 相 互 注册 ， 以 搭建 


EurekaRibbonDemo-backup-Server 主 从 热 备 的 Eureka 服务 器 集群 


EurekaRibbonDemo-ServiceProviderOne 


EurekaRibbonDemo-ServiceProviderTwo 向 Eureka 服务 器 注册 的 服务 提供 者 


EurekaRibbonDemo-ServiceProviderThree 
FeignDemo-ServiceCaller 其 中 包含 Feign 整合 Ribbon 的 代码 
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6.3.2 ”通过 Feign 以 Ribbon 负载 均衡 的 方式 调用 服务 


在 FeignDemo-ServiceCaller 项 目 里 开发 Feign 整合 Ribbon， 具 体 的 步骤 如 下 。 
步骤 014 在 pom.xml 中 ， 引 入 Ribbon 依赖 包 ， 关 键 代码 如 下 。 


和 <dependency> 

2 <groupId>org.springframework.cloud</groupId> 

3 <artifactId>spring-cloud-starter-ribbon</artifactId> 
4 </dependency> 


步 又 024 在 ControllerForFeignRibbonjava 中 ， 编 写 Feign 以 Ribbon 负载 均衡 的 方式 调用 服 
务 的 代码 。 
// 省 略 必 要 的 package 和 import 的 代码 


1 

2 // 这 和 Ribbon Provider 中 的 applicationname 一 致 
3 FeignClient (value = "sayHello") 
4 

5 

6 


interface FeignClientRibbonTool 
{ 
@RequestMapping (method = RequestMethod.GET, value = 
"/sayHello/ {username}") 
| String sayHelloAsRibbon (@PathVariable ("username") String username); 
| 
9 @RestController 
10 public class ControllerForFeignRibbon { 


@Autowired 

2 Private FeignClientRibbonTool tool; 

13 @RequestMapping (value = "/callHelloAsRibbon/{username}", method = 
RequestMethod.GET) 

14 public String callHelloAsRibbon (@PathVariable ("username") 
String username) { 

I return tool.sayHelloAsRibbon (username); 

16 } 

yr | 


在 第 4~8 行 ， 我 们 定义 了 一 个 名 为 FeignClientRibbonTool 的 接口 。 其 中 ， 在 第 3 行 中 ， 我 们 
通过 @FeignClient 注解 指定 了 该 Feign 接口 将 会 调用 名 为 sayHello 的 服务 。 请 注意 ,这 里 的 sayHello 
命名 需要 和 EurekaRibbonDemo-ServiceProviderOne 等 项 目 application.yml 中 的 相应 配置 一 致 

在 第 10~17 行 中 ， 我 们 通过 @RestController 注解 定义 了 一 个 名 为 ControllerForFeignRibbon 的 
控制 器 类 。 在 其 中 第 14 行 的 callHelloAsRibbon 中 ， 我 们 是 通过 Feign 接口 中 的 sayHelloAsRibbon 
方法 调用 服务 的 。 


步骤 034 在 application.yml 中 ， 编 写 Ribbon 的 相关 配置 信息 ， 关 键 代码 如 下 。 


sayHello: 

之 ribbon: 

3 listOfServers: http://localhost:1111/,http://localhost:2222/, 
http://localhost:3333 

4 ConnectionTimeout: 1000 

5 ribbon: 


6 ConnectionTimeout: 2000 
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在 第 1~4 行 ， 我 们 通过 配置 指定 了 基于 ribbon 的 多 人 台 服 务 器 ， 它 们 将 以 负载 均衡 的 方式 承担 
请 求 url， 而 且 还 指定 了 连接 超时 的 时 间 。 从 第 1 行 我 们 能 看 到 ， 这 个 配置 是 针对 sayHello 这 个 服 
务实 例 的 。 而 在 第 5 行 和 第 6 行 ， 我 们 配置 了 全 局 性 的 ribbon 属性 ， 这 里 也 配置 了 连接 超时 时 间 。 

完成 开发 后 ， 启 动 定义 在 表 6.2 中 的 两 台 Eureka 服务 器 、 三 台 服 务 提 供 者 和 一 台 服 务 调用 者 
程序 后 ， 在 浏览 器 中 多 次 输入 “http://localhost:8080/callHelloAsRibbon/Peter” 以 调用 服务 ， 这 时 我 
们 能 看 到 如 下 输出 。 从 输出 结果 来 看 , 我 们 以 Feign 的 形式 调用 的 请 求 确 实 被 均衡 地 转发 到 三 台 服 
务 提供 者 的 机 器 上 。 


pb Hello Ribbon, this is Serverl, my name is:Peter 
2 Hello Ribbon, this is Server2, my name is:Peter 
3 Hello Ribbon, this is Server3, my name is:Peter 


这 里 我 们 来 总 结 一 下 Feign 整合 Ribbon 的 要 点 。 


第 一 ， 多 个 服务 器 提供 者 的 实例 名 应 当 一 致 ， 比 如 这 里 都 是 sayHello。 

第 二 ， 在 Feign 的 接口 中 ， 是 通过 @FeignClient 的 注解 调用 服务 提供 者 的 方法 的 。 

第 三 , 我 们 在 application.yml 配置 文件 中 指定 Ribbon 的 各 种 参数 ， 其 实 也 可 以 像 4.5.3 小 节 描 
述 的 那样 ， 通 过 @Configuration 注解 在 Java 文件 中 配置 Ribbon 的 参数 。 


6.4 Feign 整合 Hystrix 


在 通过 Feign 调用 服务 时 ,同样 不 能 保证 服务 一 定 可 用 ,为 了 提升 客户 体验 ， 这 里 可 以 通过 引 
入 Hystrix 对 访问 请 求 进行 “容错 保护 ”。 

这 里 ， 我 们 将 重用 第 6.1 节 创 建 的 FeignDemo-Server 项 目 作为 Eureka 服务 器 ， 重 用 
FeignDemo-ServiceProvider 项 目 中 提供 的 sayHelloServiceProvider 服务 , 在 FeignDemo-ServiceCaller 
项 目 中 增加 Feign 整合 Hystrix 的 实例 代码 。 


步骤 01 A 在 FeignDemo-ServiceCaller 的 pom.xml 中 , 增加 Hystrix 的 依赖 包 , 关键 代码 如 下 。 


二 <dependency> 

2 <groupId>org.springframework.cloud</groupId> 

3 <artifactId>spring-cloud-starter-hystrix</artifactId> 
4 </dependency> 


步骤 024 还 是 在 FeignDemo-ServiceCaller 项 目的 application.yml 配置 文件 中 ， 通 过 如 下 配置 

项 启动 Hystrix 模式 ， 关 键 代 码 如 下 。 

和 feign: 

2 hystrix: 

enabled: true 

此 外 ， 还 可 以 通过 如 下 代码 配置 针对 sayHelloServiceProvider 服务 的 hystrix 参数 。 其 中 ,第 3 
行 指定 了 hystrix 所 作用 的 服务 名 ， 第 7 行 指定 了 请 求 时 间 一 旦 超过 1000 毫秒 (也 就 是 1 秒 ) ， 就 
会 启动 熔断 模式 ， 调 用 定义 在 回 退 方 法 中 的 业务 动作 。 
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hystrix: 
command: 
sayHelloServiceProvider: 
execution: 
isolation: 
thread: 
timeoutInMilliseconds: 1000 


在 第 5 章 的 5.3.2 小 节 , 我 们 在 表 5.1 中 列 出 了 一 些 和 Hystrix 熔断 相关 的 配置 参数 , 在 这 里 的 
application.yml 配置 文件 中 ， 大 家 也 可 以 根据 实际 情况 适当 地 加 些 其 他 配置 。 


步骤 034 在 启动 类 ServiceCallerApp.java 中 ,增加 启动 Hystrix 断路 器 的 注解 , 如 第 5 行 所 示 ， 


这 个 类 的 关键 代码 如 下 。 
1  // 省 略 必要 的 package 和 import 方法 
加 EnableFeignClients 
2 @EnableDiscoveryClient 
4 @SpringBootApplication 
5 QEnableCircuitBreaker 
6 Ppublic class ServiceCallerApp 
me | 
8 // 省 略 其 他 代码 
SY 


Marw 


步骤 044 新 建 一 个 名 为 ControllerForFeignHystrix.java 的 控制 器 类 ， 代 码 如 下 。 


// 省 略 必 要 的 Package 和 import 代码 
Q@FeignClient (value = "sayHelloServiceProvider", 
fallback=FeignClientHystrixToolFallback.class) 
interface FeignClientHystrixTool{ 
@RequestMapping (method = RequestMethod.GET, value = "/hello/{name}") 
String sayHelloInClient (@RequestParam("name") String name); 
} 


在 第 3 行 中 ， 我 们 定义 了 一 个 名 为 FeignClientHystrixTool 的 接口 ; 在 第 2 行 的 注解 中 ， 我 们 
定义 了 它 将 以 Feign 的 形式 调用 sayHelloServiceProvider 中 的 服务 , 并 且 通 过 fallback 配置 指定 一 旦 
出 现 调 用 异常 ， 将 调用 FeignClientHystrixToolFallback 类 中 的 回 退 方法 。 


7 
8 
9 


10 
i 


@Component 

class FeignClientHystrixToolFallback implements FeignClientHystrixTool{ 
Public String sayHelloInClient (String name) 
{ return "In Fallback Function."; } 

} 


在 第 8 行 的 FeignClientHystrixToolFallback 类 中 , 我 们 将 定义 针对 FeignClientHystrixTool 接口 


退 方 法 。 


该 类 必须 和 第 2 行 中 fallback 指定 的 类 同名 ， 而 且 需 要 实现 (implements ) 


FeignClientHystrixTool 接口 ， 在 其 中 的 sayHelloInClient 方法 中 定义 回 退 动作 ， 这 里 的 动 
作 是 打印 一 段 话 。 
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12 Q@RestController 
13 public class ControllerForFeignHystrix { 


14 @Autowired 

5 Private FeignClientHystrixTool] tool; 

16 @RequestMapping (value = "/callHelloAsHystrix/{username}", 
method = RequestMethod.GET) 

lg! public String callHelloAsHystrix(@PathVariable ("username") 
String username) 

18 { return tool.sayHelloInClient (username);} 

19 


在 第 13 行 中 ,我 们 定义 了 一 个 包含 @RestController 注解 的 控制 器 类 ControllerForFeignHystrix， 
在 其 中 第 17 行 的 callHelloAsHystrix 方法 中 ， 我 们 是 以 Feign 的 形式 调用 sayHelloInClient 方法 的 。 

至 此 ， 完 成 代码 的 编写 工作 。 我 们 依次 启动 FeignDemo-Server、FeignDemo-ServiceProvider 和 
FeignDemo-ServiceCaller 项 目 ,随后 在 浏览 器 中 输入 “http://localhost:8080/callHelloAsHystrix/Peter”， 
此 时 能 看 到 “hello Peter” 的 输出 ， 这 个 是 正常 的 调用 流程 。 

如 果 我 们 关闭 FeignDemo-ServiceProvider 项 目 ， 也 就 是 说 sayHelloServiceProvider 服务 不 可 用 
了 ， 如 果 再 次 在 浏览 器 中 输入 “http://localhost:8080/callHelloAsHystrix/Peter”， 此 时 就 会 走 熔断 保 
护 的 流程 ,触发 FeignClientHystrixToolFallback 类 中 的 sayHelloInClient 方法 , 在 浏览 器 中 输出 “In 
Fallback Function.” 的 字样 。 


6.5 本 章 小 结 


由 于 Feign 能 封装 一 些 较为 复杂 的 请 求 细节 ， 因 此 Feign 能 让 程序 员 用 比较 简单 的 方式 调用 服 
务 ， 这 样 能 大 大 降低 客户 端 请 求 调用 部 分 代码 的 复杂 度 。 而 且 ，Feign 还 能 便捷 地 整合 Ribbon 和 
Hystrix 等 组 件 ， 从 而 能 让 程序 员 更 为 高 效 地 实现 负载 均衡 和 熔断 保护 等 机 制 。 

总 之 ，Feign 使 用 起 来 比较 简便 ， 既 能 提升 程序 员 的 开发 效率 ， 也 能 方便 地 整合 其 他 组 件 ， 从 
而 降低 了 开发 者 的 能 力 门槛 。 这 就 是 Feign 组 件 的 价值 所 在 。 


第 / 章 


微服 务 架构 的 网 关 组 件 : Zuul 


在 之 前 的 章节 中 ， 服 务 使 用 者 是 直接 调用 服务 的 ， 但 在 真实 的 项 目 场景 中 不 会 简单 地 这 么 做 。 
事实 上 ,大 多 数 基于 微服 务 的 应 用 系统 在 收 到 请 求 后 , 在 服务 提供 者 处 理 这 些 请 求 前 ， 有 可 能 验证 
这 些 请 求 的 合法 性 , 比如 没 通过 身份 验证 就 无 法 提供 服务 , 还 有 可 能 通过 一 定 的 路 由 算法 把 这 些 请 
求 分 派 到 合适 的 集群 服务 器 上 , 甚至 还 有 可 能 出 于 效率 方面 的 考虑 , 把 一 些 请 求 直 接 定位 到 静态 页 
面 上 ， 而 不 是 发 送 到 提供 服务 的 模块 中 。 

从 系统 可 维护 性 的 角度 来 看 ， 上 述 针 对 请 求 的 动作 不 应 当 放 在 提供 业务 的 模块 中 ， 因 为 针对 
请 求 处 理 规则 的 变更 不 应 当 影响 业务 功能 逻辑 。 

事实 上 , 在 网 络 架 构 体 系 中 ,针对 请 求 的 处 理 动作 一 般 封装 在 网 关 层 ,而 在 Spring Cloud 微服 
务 架 构 体 系 中 ,会 采用 Netflix 框架 中 的 Zuul 组 件 来 开发 网 关 部 分 的 功能 。 本 章 将 结合 实际 案例 讲 
述 通过 Zuul 组 件 实现 “过 滤 请 求 ” 和 “路 由 请 求 ” 等 网 关 层 常规 动作 的 做 法 。 


7.1 通过 案例 人 门 Zuul 组 件 的 用 法 


本 章 开篇 已 经 提 到 ， 在 Spring Cloud 微服 务 的 架构 体系 中 ， 我 们 可 以 选择 Zuul 组 件 来 构建 网 
关 。 这 里 ， 我 们 将 通过 一 个 案例 来 向 大 家 演示 通过 Zuul 组 件 搭建 网 关 的 做 法 ， 同 时 让 大 家 能 感性 
地 体会 到 网 关 的 作用 。 


7.1.1 搭建 简单 的 基于 Zuul 组 件 的 网 关 


这 里 将 重用 第 6 章 的 FeignDemo-Server 项 目 作为 Eureka 服务 器 ,用 FeignDemo-ServiceProvider 
项 目 作 为 服务 提供 者 。 启动 这 两 个 项 目 后 , 在 浏览 器 中 输入 “http://localhost:8888/”, 能 看 到 Eureka 
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的 控制 台 页 面 ， 输 入 “http:Wlocalhost:111lhello/peter” 后 ， 能 看 到 有 “hello peter” 的 输出 。 
在 第 6 章 中 ,我们 已 经 详细 讲述 过 这 两 个 项 目的 具体 功能 ， 这 里 就 不 再 著述 了 。 在 本 小 节 ， 
我 们 将 以 如 下 步骤 通过 Zuul 搭建 一 个 能 访问 封装 在 FeignDemo-ServiceProvider 项 目 中 服务 的 网 关 。 
代码 位 置 视频 位 置 
代码 \ 第 7 章 \SimpleZuulDemo 视频 \ 第 7 章 \ 拱 建 简单 的 基于 Zuul 的 网 关 
步骤 01 创建 名 为 SimpleZuulDemo 的 Maven 项 目 ， 并 在 其 中 的 pom.xml 文件 中 增加 Zuul 
的 依赖 包 ， 关 键 代 码 如 下 。 在 这 个 pom.xml 中 ， 无 须 引 入 Eureka 等 其 他 组 件 的 依赖 包 。 


下 <dependency> 

<groupId>org.springframework.cloud</groupId> 
和 3 <artifactId>spring-cloud-starter-zuul</artifactId> 
4 </dependency> 


步 又 024 编写 启动 类 ZuulApp.java。 


到 // 省 略 其 他 package 和 import 代码 

2  Q@EnableZuulProxy 

3  @SpringBootApplication 

4 public class ZuulApp 

S040 

6 public static void main( String[] args ) 

区 { 

8 SpringApplication.run(ZuulApp.class, args); 
9 

3 站 


在 第 2 行 中 ， 我 们 通过 注解 让 这 个 启动 类 具有 Zuul 网 关 的 功能 ， 通 过 第 8 行 代码 ， 我 们 能 启 
动 这 个 基于 Zuul 网 关 的 Spring Boot 应 用 程序 。 
步骤 034 在 application.yml 里 ， 配 置 Zuul 网 关 的 参数 ， 代 码 如 下 。 


人 L spring: 

2 application: 
3 name: zuulServer 
4 server: 

5 por 5555 
6 zuul: 

7 routes: 

8 zuul-url: 

9 aril http /localboac ay 


其 中 ,第 1~3 行 指定 了 本 项 目 对 外 提供 服务 的 名 字 ， 这 里 是 zuulServer,， 在 第 4 行 和 第 5 行 指 
定 了 本 项 目 对 外 提供 服务 的 端口 ， 这 里 是 5555。 

比较 关键 的 是 第 6-9 行 的 代码 ， 配 置 了 这 些 参数 后 ， 发 往 网 关 的 url 请 求 会 被 转发 到 
localhost:1111 这 个 url 上 《〈 即 FeignDemo-ServiceProvider 对 外 提供 服务 的 url) 。 

其 中 ， 第 6 行 和 第 7 行 属于 固定 写法 ， 说 明 后 面 第 8 行 和 第 9 行 的 配置 是 属于 Zuul 网 关 路 由 
规则 的 。 在 第 8 行 中 指定 了 网 关 的 路 由 关键 字 ， 在 第 9 行 中 指定 了 通过 Zuul 网 关 路 由 的 目的 地 。 
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7.1.2 ”通过 运行 结果 体会 Zuul 转发 请 求 的 效果 


在 启动 FeignDemo-Server 和 FeignDemo-ServiceProvider 项 目的 基础 上 ， 同 时 通过 ZuulApp 类 
启动 SimpleZuulDemo 项 目 ， 此 时 在 浏览 器 中 输入 “http://localhost:5555/zuul-url/hello/peter”， 也 能 
看 到 有 “hello peter” 的 输出 。 

这 里 ,我 们 详细 看 一 下 通过 网 关 转 发 url 的 细节 , 根据 请 求 url 的 前 半 部 分 http://localhost:5555 
中 的 端口 号 ， 本 url 将 会 被 SimpleZuulDemo 项 目 解析 并 处 理 ， 根 据 在 application.yml 中 第 8 行 和 
第 9 行 的 配置 ，http://localhost:5555/zuul-url/ 这 部 分 url 其 实 等 价 于 http://localhost:1111/。 

再 进一步 ，http://localhost:5555/zuul-url/hello/peter 整个 url 将 会 被 Zuul 组 件 经 路 由 转发 到 
FeignDemo-ServiceProvider 服务 提供 者 项 目 上 ， 说 得 通俗 一 点 ,该 ul 其实 等 价 于 
http://localhost:1111/hello/peter， 这 就 是 大 家 能 看 到 “hello peter” 输 出 的 原因 。 

从 上 述 案例 中 ， 我 们 能 看 到 发 送 到 Zuul 网 关 的 请 求 会 根据 配置 文件 中 的 定义 转发 到 对 应 的 服 
务 上 进行 处 理 ， 这 属于 Zuul 网 关 的 “路 由 ”功能 。 这 里 的 路 由 功能 比较 简单 ， 在 后 文中 将 给 出 诸 
如 跳 转 路 由 和 通过 正则 表达 式 自 定义 路 由 等 复杂 路 由 的 实现 方案 。 


7.2 ”Zuul 请 求 过 滤器 


和 Spring 过 滤器 一 样 ，Zuul 过 滤器 也 能 处 理 url 请 求 的 各 个 阶段 拦截 、 处 理 或 继续 发 送 请 求 。 
同样 ， 我 们 也 可 以 用 基于 责任 链 的 模式 配置 多 个 Zuul 过 滤器 。 在 这 种 模式 中 ， 当 请 求 到 达 当 前 过 
滤器 时 ， 如 果 需 要 处 理 就 处 理 ， 否 则 可 以 转发 到 下 个 处 理 模 块 ， 直 到 请 求 处 理 完成 。 

使 用 Zuul 过 滤器 的 一 般 方式 是 ， 继 承 ZuulFilter 抽象 类 ， 并 通过 重 写 其 中 的 4 个 方法 定义 过 
滤器 的 执行 条 件 、 过 滤 类 型 、 执 行 次 序 以 及 过 滤器 具体 的 操作 。 


7.2.1 http 请 求生 命 周 期 和 Zuul 过 滤器 


在 ZuulFilter 抽象 类 中 ， 有 如 下 4 个 比较 重要 的 方法 。 


a boolean shouldFilter(); 
2 int filterOrder(); 

3 Object run(); 

4 String filterType(); 


其 中 ， 通 过 重 写 第 1 行 的 shouldFilter 方法 ， 我 们 能 指定 该 过 滤器 是 否 生效 。 通 过 第 2 行 的 int 
类 型 的 filterOrder 方法 ， 我 们 能 定义 过 滤器 的 执行 次 序 ， 即 优先 级 ， 返 回 的 int 型 值 越 小 ， 优 先 级 
越 高 。 在 第 3 行 的 run 方法 中 ,我 们 可 以 定义 过 滤器 的 具体 逻辑 ， 比 如 如 何 过 渡 或 重 写 请 求 。 而 通 
过 第 4 行 的 方法 ， 我 们 可 以 定义 该 过 滤器 的 类 型 ， 该 方法 指定 的 过 滤器 类 型 和 http 请 求 的 生命 周 
期 密切 相关 。 

一 个 http 请 求 (Request) 从 经 Zuul 网 关 到 处 理 结束 〈 即 一 次 请 求 的 生命 周期 )， 一 般 流 程 为 : 
首先 被 Zuul 网 关 路 由 到 合适 的 服务 器 ， 之 后 被 服务 器 上 的 业务 模块 处 理 ， 发 生 异常 时 会 被 异常 处 
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理 模块 处 理 ， 最 后 请 求 发 起 方 会 收 到 返回 结果 (Response) 。 

通过 Zuul 组 件 ， 我 们 可 以 设置 pre、post、route 和 error 四 种 类 型 的 过 滤器 , 在 上 述 每 个 HTTP 
请 求 和 处 理 的 流程 中 , 都 有 一 类 Zuul 过 滤器 与 之 对 应 。 从 图 7.1 中 , 我 们 能 看 到 Zuul 过 滤器 和 http 
生命 周期 的 对 应 关系 。 


http 请 求 


[DIEj 过 波 器 | A 网 关 一 一 


route 过 滤器 


响应 结果 


和 此 了 时 要 并 壕 俩 泪 


图 7.1 http 请 求生 命 周期 和 Zuul 四 类 过 滤器 的 关系 


总 结 一 下 http 请 求生 命 周期 和 Zuul 过 滤器 的 对 应 关系 ， 前 提 是 我 们 已 经 通过 filterType 方法 
定义 了 下 面 所 有 类 型 的 过 滤器 。 


第 一 ， 请 求 在 被 Zuul 网 关 路 由 前 可 以 被 pre 过 滤器 处 理 。 

第 二 ， 在 请 求 被 路 由 时 会 触发 route 过 滤器 。 

第 三 ， 当 处 理 http 请 求 发 生 异 常 时 会 触发 error 过 滤器 。 

第 四 ， 当 请 求 被 route 或 error 过 滤器 处 理 后 会 触发 post 过 滤器 。 


而 且 ， 针 对 同一 种 类 型 ， 我 们 可 以 定义 一 个 或 多 个 Zuul 过 滤器 ， 同 一 种 类 型 的 过 滤器 可 以 通 
过 filterOrder 方法 来 确定 调用 次 序 。 


7.2.2 ”过 滤器 的 常规 用 法 


这 里 ， 我 们 将 通过 创建 pre 过 滤器 的 案例 来 向 大 家 演示 Zuul 过 滤器 的 基本 用 法 。 具 体 而 言 ， 
将 通过 如 下 步骤 ， 在 前 文中 创建 的 SimpleZuulDemo 项 目 中 添加 pre 类 型 的 过 滤器 。 


步骤 014 新 建 一 个 名 为 MyPreFilter 的 java 类 ， 这 个 类 将 继承 ZuulFilter， 并 在 其 中 重 写 
ZuulFilter 的 4 个 方法 ， 代 码 如 下 。 


// 省 略 必 要 的 package 和 import 代码 
// 继 承 了 zuulFilter 类 
Public class MyPreFilter extends ZuulFiltert{ 
// 重 写 了 run 方法 
Public Object run() { 
System.out .println("in myPreFilter, type is Pre") 7 
// 通 过 RequestContext 对 象 得 到 HttpServletRequest 对 象 
RequestContext ctx = RequestContext.getCurrentContext () 
HttpServletRequest request = ctx.getRequest () 7 
// 得 到 请 求 ur1 
String url = request .getRequestURI (); 
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System.out .println (url); 

// 如 果 请 求 url 中 没有 包括 hel1o， 就 不 继续 往 后 走 了 

if( url.indexOf ("hello") == -1 )1{ 
System.out .println ("Blocked by Pre Filter."); 
ctx.setSendZzuulResponse (false); 
ctx.setResponseStatusCode (404); 

} 

// 继 续 往 后 走 


return null; 


} 

// 返 回 true， 说 明 启用 这 个 过 滤器 
Public boolean shouldFilter() 
{ return true; } 

// 设 置 本 过 滤器 的 优先 级 

public int filterOrder() 

{ return 17 } 


// 设 置 本 过 滤器 的 类 型 
public String filterType() 
{ return "pre"; } 


} 


在 第 5 行 的 run 方法 中 , 我 们 定义 了 本 过 滤器 的 业务 动作 。 具 体 而 言 , 在 第 8 行 得 到 了 请 求 上 
下 文 ， 同 时 在 第 9 行 通过 上 下 文 得 到 了 请 求 对 象 request。 在 第 11 行 中 ， 通 过 请 求 对 象 得 到 了 url， 
并 通过 第 14 行 的 让 语句 判断 是 否 该 拦截 这 个 请 求 。 

通过 站 语句 中 的 第 16 行 和 第 17 行 代码 ， 我 们 知道 了 如 果 在 url 中 不 包括 hello， 就 会 拦截 这 
个 请 求 ， 同 时 返回 404 错误 。 反 之 ， 则 通过 第 20 行 的 return 代码 把 请 求 继续 下 发 。 

在 第 23 行 的 shouldFilter 方法 中 ， 我 们 通过 return true 设置 该 过 滤器 是 有 效 的 ， 通 过 第 26 行 
的 filterOrder 方法 ， 我 们 设置 了 该 过 滤器 的 优先 级 是 1; 通过 第 29 行 的 代码 ， 我 们 设置 了 本 过 波 


器 的 类 型 


是 “pre”， 即 请 求 在 经 网 关 转 发 前 会 被 本 过 滤器 处 理 。 


步骤 02h 在 启动 类 ZuulApp.java 中 ， 通 过 @Bean 注解 配置 第 一 步 定义 的 过 滤器 ， 代 码 如 下 。 


o ~ aowmwwnP 


// 省 略 必要 的 package 和 import 代码 
@EnableZuulProxy 
@SpringBootApplication 
public class ZuulApp 
{ 
// 配 置 过 滤器 
@Bean 
Public MyPreFilter myPreRequestFilter (){ 
return new MyPreFilter(); 


小 
// 启 动 类 
Public static void main( String[] args ){ 
SpringApplication.run(ZuulApp.class, args); 
} 


在 第 7~10 行 的 myPreRequestFilter 方法 中 ,我 们 返回 了 MyPreFilter 类 型 的 对 象 ， 并 且 该 方法 
有 @Bean 注解 。 这 样 ， 当 本 类 启动 时 ，MyPreFilter 过 滤器 会 自动 向 Spring 容器 注册 。 
启动 FeignDemo-Server、FeignDemo-ServiceProvider 和 SimpleZuulDemo 项 目 ， 如 果 在 浏览 器 
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中 输入 “http://localhost:5555/zuul-url/hello/peter”， 我 们 在 浏览 器 中 看 到 “hello peter” 输 出 的 同时 ， 
在 控制 台中 还 能 看 到 输出 “in myPreFilter, type is pre”， 这 说 明 过 滤器 已 经 生效 。 

如 果 我 们 在 浏览 器 中 故意 输入 错误 的 请 求 “http://localhost:5555/zuul-url/errorCall/peter”， 由 于 
其 中 不 包含 “hello”， 因 此 在 控制 台中 能 看 到 输出 “Blocked by Pre Filter.”， 且 在 浏览 器 上 能 看 到 
404 错误 ， 这 说 明 该 错误 请 求 被 过 滤器 处 理 并 拦截 。 


7.2.3 ”指定 过 滤器 的 优先 级 


在 这 个 案例 中 ， 我 们 不 仅 将 在 当前 SimpleZuulDemo 项 目的 基础 上 继续 添加 一 个 route 和 两 个 
post 类 型 的 过 滤器 ， 并 通过 filterOrder 方法 指定 两 个 post 过 滤器 的 运行 次 序 ， 以 此 来 演示 过 滤器 优 
先 级 的 效果 ， 有 具体 步骤 如 下 。 
步骤 014 在 FeignDemo-ServiceProvider 这 个 提供 服务 的 项 目 中 ， 我 们 是 在 Controllerjava 控 
制 器 类 中 的 sayHello 方法 中 定义 对 外 服务 的 具体 动作 的 。 这 里 ， 我 们 在 第 4 行 和 第 5 行 中 增加 打 
印 时 间 的 代码 ， 关 键 代 码 如 下 。 


@RequestMapping (value = "/hello/{username}", method = RequestMethod.GET 


System.out.println("In Service Provice."); 


外 

) 

2 public String sayHello(@PathVariable("username") String username) { 

2 

4 SimpleDateFormat timeFormat=new SimpleDateFormat ("yyyy-MM-dd HH:mm: 


ss SSS"); 
3 System.out .Println (timeFormat.format (new java.util.Date())); 
6 return "hello " + username; 
| 


步骤 02 人 在 SimpleZuulDemo 项 目 中 ， 增 加 一 个 名 为 MyRouteFilter 的 route 类 型 的 过 滤器 ， 
代码 如 下 。 


1 “// 省 略 必要 的 package 和 import 代码 

2 public class MyRouteFilter extends ZuulFilteri 

3 public Object run() { 

4 System.out .Println("this is route filter"); 

3 SimpleDateFormat timeFormat=new SimpleDateFormat ("yyyy-MM-dd HH: 
mm:ss SSS"); 

6 System.out .println (timeFormat.format (new java.util.Date())); 

return null; 

8 } 

9 // 定 义 是 否 启用 

10 Public boolean shouldFilter() 

ll { return true; } 

1 // 定 义 运行 次 序 

3 public int filterOrder() 

14 { return 1; } 

3 // 定 义 过 滤器 的 类 型 

16 Public String filterType() 

1 { return "route"; } 
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同样 的 ， 这 个 类 继承 了 ZuulFilter， 并 重 写 了 其 中 的 4 个 方法 。 

在 第 3 行 的 run 方法 中 ， 我 们 定义 了 该 过 滤器 的 业务 动作 ， 这 里 主要 是 输出 当前 时 间 ; 在 第 
10 行 的 shouldFilter 方法 中 ,我 们 定义 了 该 过 滤器 处 于 “启用 状态 ”; 在 第 13 行 的 filterOrder 方法 
中 ， 定 义 了 该 过 滤器 的 运行 次 序 ， 在 第 16 行 的 filterType 方法 中 ， 定 义 了 该 过 滤器 的 类 型 。 

步 最 034 增加 两 个 post 类 型 的 过 滤器 。 其 中 ， 第 一 个 post 过 滤器 的 代码 如 下 。 


1 ， // 省 略 必 要 的 package 和 import 代码 

2 public class MyFirstPostFilter extends ZuulFilter{ 

3: public Object run() { 

4 System.out.println("this is my first Post filter"); 

5 SimpleDateFormat timeFormat=new SimpleDateFormat ("yyyy-MM-dd HH: 
mm:ss SSS") 7 

6 System.out .Println (timeFormat .format (new java.util.Date())) 7 

gy return null; 

8 和 

9 Public boolean shouldFilter() 

10 { return true; } 

和 public int filterOrder() 

之 { return 17 } 

13 Public String filterType() 

14 { return "post"; } 

15 1} 


这 里 的 代码 和 之 前 的 pre 以 及 route 过 滤器 很 相似 ， 同 样 是 在 run 方法 中 打印 了 当前 的 时 间 ， 
不 过 在 这 里 的 第 11 行 的 filterOrder 方法 中 指定 了 该 post 过 滤器 的 运行 次 序 是 1, 在 第 13 行 中 指定 
了 该 过 滤器 是 post 类 型 的 。 
而 第 二 个 post 类 型 过 滤器 MySecondPostFilterjava 的 代码 和 MyFirstPostFilterjava 非常 相似 ， 
重要 的 改动 点 是 : 通过 重 写 filterOrder 方法 把 该 方法 的 运行 次 序 设置 成 了 5。 

于 public int filterOrder () 

2 { return 5;} 


步骤 044 在 ZuulAppjava 中 ， 通 过 @Bean 注解 配置 刚才 定义 的 过 滤器 ， 新 添加 的 代码 如 下 。 


eBean // 配 置 route 过 滤器 

Public MyRouteFilter myPreRouteFilter() 

{ return new MyRouteFilter(); } 

@Bean // 配 置 第 一 个 post 过 滤器 

Public MyFirstPostFilter myFirstPostFilter() { 

return new MyFirstPostFilter(); 

} 

@Bean // 配 置 第 二 个 post 过 滤器 

Public MySecondPostFilter mySecondPostFilter() 
0 { return new MySecondPostFilter(); } 


Foowamwmewn 


至 此 , 完成 代码 改写 。 启动 FeignDemo-Server、 FeignDemo-ServiceProvider 和 SimpleZuulDemo 
项 目 ， 在 浏览 器 中 输入 “http://localhost:5555/zuul-url/hello/peter”， 此 时 能 在 FeignDemo-ServiceProvide 
和 SimpleZuulDemo 项 目的 控制 台中 看 到 一 连 串 的 输出 语句 ， 我 们 按时 间 次 序 整理 如 下 。 


时 in myPreFilter, type is pre 
2 2018-07-04 22:35:44 625 
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PPieoomowaouwww 


0 


/zuul-url/hello/peter 

this is route filter 

2018-07-04 22:35:44 625 

In Service Provice. // 说 明 ， 该 行 是 由 FeignDemo-ServiceProvider 输出 的 
2018-07-04 22:35:44 640 // 说 明 ， 该 行 是 由 FeignDemo-ServiceProvider 输出 的 
this is my first post filter 

2018-07-04 22:35:44 640 

this is my second post filter 

2018-07-04 22:35:44 640 


针对 上 述 输出 ， 我 们 能 得 出 下 面 的 两 点 结论 。 

第 一 ， 过 滤器 和 路 由 请 求 的 触发 次 序 是 : pre 过 滤器 一 route 过 滤器 一 发 起 路 由 请 求 一 调用 服务 
一 post 过 滤器 。 

第 二 , 在 filterOrder 方法 中 定义 的 运行 次 序 是 针对 同类 过 滤器 而 言 的 , 比如 在 MyFirstPostFilter 
中 的 值 是 1， 而 在 MySecondPostFilter 中 的 值 是 5， 所 以 前 者 先 运 行 。 

route 过 滤器 总 是 先 于 post 过 滤器 运行 ,哪怕 我 们 把 route 过 滤器 中 的 运行 次 序 设置 成 100, post 
过 滤器 中 的 运行 次 序 设 置 成 1，route 照样 会 先 于 post 运行 。 


7.2.4 通过 error 过 滤器 处 理 路 由 时 的 异常 情况 


在 讲述 error 过 滤器 之 前 , 我 们 先 来 看 一 下 在 过 滤器 业务 动作 中 发 生 异常 时 的 处 理 方式 。 比 如 ， 
在 7.2.2 小 节 定义 的 pre 类 型 的 MyPreFilter 过 滤器 中 ， 在 其 中 实现 过 滤器 业务 动作 的 run 方法 中 ， 
我 们 故意 引发 了 RuntimeException"， 即 除 以 零 异 常 ， 代 码 如 下 。 


//MyPreFilter 类 的 run 方法 
Public Object run() { 


oamwmwwNP 


System.out .Println("in myPreFilter, type is pre"); 
// 通 过 RequestContext 对 象 得 到 HttpServletRequest 对 象 
RequestContext ctx = RequestContext.getCurrentContext (); 
HttpServletRequest request = ctx.getRequest (); 

// 得 到 请 求 url 

String url = request.getRequestURI (); 

System.out .println (url); 

//throw exception 

int i = 0; 

System.out.println(7/i); 

//… 省 略 后 继 代码 


return null; 


我 们 知道 ， 第 12 行 除 以 0 的 代码 会 触发 运行 期 异常 (RuntimeException) ， 但 如 果 我 们 此 时 
启动 相关 的 服务 ， 随 后 在 浏览 器 中 输入 “http://localhost:5555/zuul-url/hello/peter”， 得 到 的 结果 却 是 : 
第 一 ， 在 浏览 器 中 看 不 到 任何 输出 ， 第 二 ， 在 ZuulApp 的 控制 台中 看 不 到 任何 同 异 常 相关 的 输出 。 

我 们 在 编写 代码 时 ， 当 异常 出 现 后 ， 应 当 明 确 地 指明 异常 类 型 以 及 异常 点 的 位 置 ， 这 样 就 很 
容易 分 析 和 解决 问题 。 在 使 用 过 滤器 的 场景 中 ， 我 们 应 当 引 入 error 过 滤器 来 捕获 和 抛 出 异常 。 

关键 步骤 如 下 : 
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步骤 01 4 在 SimpleZuulDemo 项 目 中 , 增加 一 个 名 为 MyErrorFilter 的 error 类 型 过 滤器 , 代码 如 下 。 


1 “// 省 略 必 要 的 package 和 import 代码 

2 public class MyErrorFilter extends ZuulFiltert{ 

2 public Object run() { 

4 System.out.println("in MyErrorFilter, type is error"); 
5 // 得 到 请 求 上 下 文 

6 RequestContext context = RequestContext.getCurrentContext (); 
了 // 得 到 异常 对 象 

8 Throwable throwable = context.getThrowable(); 
9 // 输 出 异常 链 

10 throwable.printStackTrace (); 

3 // 在 页 面 上 显示 出 错误 提示 信息 

12 Context .setResponseBody ("Error happens."); 

13 return null; 

14 } 

15 // 启 用 该 过 滤器 

16 Public boolean shouldFilter() 

3 { return true; } 

18 // 设 置 该 过 滤器 的 运行 次 序 

19 public int filterOrder() 

20 { return 1; } 

2 // 设 置 该 过 滤器 的 类 型 

22 public String filterType() 

23 { return "error"; } 

24 1} 


上 述 类 MyErrorFilter 同样 实现 了 ZuulFilter 的 4 个 方法 ， 在 其 中 第 22 行 的 filterType 方法 中 ， 
我 们 指定 了 该 过 滤器 的 类 型 为 error， 在 第 3 行 的 run 方法 中 ， 我 们 一 方面 通过 第 10 行 的 代码 输出 
了 异常 链 信 息 ， 同 时 又 在 第 12 行 中 通过 请 求 上 下 文 对象 context 向 浏览 器 中 输出 了 错误 提示 信息 ， 
从 而 让 用 户 看 到 一 个 比较 友好 的 出 错 提示 页 面 。 

步骤 024 在 ZuulAppjava 中 ， 通 过 @Bean 注解 配置 上 述 的 error 过 滤器 ， 关 键 代 码 如 下 。 

@Bean 

Public MyErrorFilter myErrorFilter() { 

a return new MyErrorFilter(); 

a } 

此 时 ， 当 重启 ZuulApp.java 类 后 , 在 浏览 器 中 再 次 输入 “http://localhost:5555/zuul-url/hello/peter”， 
则 能 看 到 如 下 两 方面 的 错误 提示 信息 。 


第 一 ,在 控制 台中 能 看 到 如 图 7.2 所 示 的 异常 提示 信息 。 通过 它 ,我 们 能 清晰 地 了 解 错 误 的 类 
型 ， 并 能 快速 地 定位 到 发 生 问题 的 代码 点 。 
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第 二 ， 在 浏览 器 中 能 看 到 “Error happens.” 的 字样 。 这 里 只 是 一 个 演示 案例 ， 所 以 提示 的 字样 
非常 简单 。 在 实际 项 目 中 ， 发 生 错 误 后 ， 我 们 可 以 在 浏览 器 中 清晰 明了 地 告诉 用 户 该 怎么 办 。 


7.2.5 ”动态 增加 过 滤器 


我 们 固然 可 以 通过 修改 现 有 的 代码 来 增加 Zuul 过 滤器 ， 但 是 必须 通过 重启 服务 器 才能 生效 。 
在 有 些 重要 的 服务 场景 中 ， 我 们 需要 保证 服务 的 连续 性 ， 所 以 重启 服务 器 的 次 数 将 会 被 严格 限制 。 
在 这 种 场景 中 ， 我 们 就 得 用 本 小 节 给 出 的 技巧 动态 地 增加 各 种 类 型 的 过 滤器 。 
我 们 将 在 SimpleZuulDemo 项 目 中 ， 通 过 基于 Groovy 语言 的 方式 动态 地 增加 过 滤器 ， 具 体 步 
又 如 下 。 
步骤 014 在 项 目的 src/main/java 目录 下 新 建 若干 个 目录 ， 用 来 存放 动态 新 增 的 过 滤器 ， 目 录 
结果 如 图 7.3 所 示 。 


日 - 税 SimpleZuulDemo 
日 名 src/nain java 

日 -出 com 
由 - 国 

由 - 南 com. filter 
册 MyFilterPath. post 

田 记 NyFilterPath. pre 
册 MyFilterPath. route 
| application. yml 


图 7.3 用 来 存放 新 增 过 滤器 的 目录 结构 


其 中 MyFilterPath.pre 目录 中 可 以 存放 新 增 的 pre 类 型 的 过 滤器 ， 以 此 类 推 。 请 大 家 注意 这 个 

目录 结构 ， 如 果 写 错 的 话 ， 可 能 会 导致 后 面 无 法 正确 地 动态 装载 新 增 的 过 滤器 。 
步 又 024 在 pom.xml 中 新 增 Groovy 的 依赖 包 ,这 里 我 们 用 到 的 是 2.4.6 版 本 ,关键 代码 如 下 。 

TL <dependency> 

了 <groupId>org.codehaus .groovy</groupId> 
3 <artifactId>groovy-al1</artifactId> 
4 
5 


<version>2.4.6</version> 
</dependency> 


Groovy 语言 和 Java 一 样 ， 也 是 基于 JVM (Java 虚拟 机 ) 的 。 我 们 知道 ， 在 Java 程序 运行 过 


程 中 ，JVM 只 能 调用 已 经 存在 的 方法 ,否则 会 报错 。 但 Groovy 允许 我 们 在 运行 时 动态 地 添加 属性 
或 方法 ， 所 以 这 里 我 们 可 以 利用 Groovy 的 这 个 特性 来 动态 增加 过 滤器 。 


步骤 034 我 们 需要 在 启动 类 ZuulAppjava 中 编写 基于 Groovy 的 动态 增加 过 滤器 的 代码 ， 具 
体 代码 如 下 。 
// 省 略 必要 的 package 和 import 代码 
// 指 定 本 类 启动 时 ， 能 读 取 配置 文件 中 zuul .filter 的 配置 项 


@ConfigurationProperties ("zuul.filter") 
@EnableZuulProxy 


心 w N 
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5  Q@SpringBootApplication 
6 Ppublic class ZuulApp { 
7 
8 


// 如 下 两 个 属性 是 定义 在 配置 文件 中 的 
private String root; // 从 root 路 径 中 读 过 滤器 类 
9 private String interval; // 每 隔 多 久 读 一 次 
10 // 省 略 针 对 root 和 interval 的 get 和 set 方法 
和 @Bean 
2 Public FilterLoader refreshZuulFilter() { 
13 FilterLoader zuulFilterLoader = FilterLoader.getInstance(); 
14 zuulFilterLoader.setCompiler (new GroovyCompiler()); 
1S try { 
1 FilterFileManager.setFilenameFilter (new GroovyFileFilter()); 
yj FilterFileManager.init(Integer.valueOf (getInterval ()), 
18 this.getRoot()+ "/pre", 
19 this.getRoot() + "/route", 
20 this.getRoot() + "/post"); 
2 } catch (Exception e) { 
2 人 e.pPrintStackTrace () 7 
23 } 
24 return zuulFilterLoader; 
和 } 
26 // 启 动 类 
27 Public static void main( String[] args ) 
28 { 
29 SpringApplication.run(ZuulApp.class, args); 
30 } 
i 
在 第 3 行 中 ， 我 们 通过 @ConfigurationProperties 注解 ， 在 本 程序 运行 时 ， 到 配置 文件 中 读 取 


zuul.filter 信息 。 
在 application.yml 文件 中 会 有 如 下 配置 ， 所 以 说 ， 当 ZuulApp 类 启动 时 ， 定 义 在 第 8 行 和 第 9 
行 的 root 和 interval 两 个 属性 会 自动 地 被 赋予 “10” 和 “MyFilterPath” 两 个 值 。 


于 zuul: 

= filter: 

六 root: MyFilterPath 
4 interval: 10 


其 中 ，root 表示 该 从 哪个 路 径 里 读 取 过 滤器 ， 而 interval 则 表示 每 隔 多 久 去 读 ，interval 属性 值 
的 单位 是 秒 。 在 实际 项 目 中 , 我 们 为 了 减轻 系统 压力 , 可 以 每 隔 1 小 时 去 读 , 但 这 里 为 了 演示 方便 ， 
设置 了 10 秒 。 

在 第 12 行 的 refreshZuulFilter 方法 中 ， 我 们 设置 动态 读 取 过 滤器 的 动作 ， 该 方法 的 关键 是 第 
17 行 的 init 方法 ， 在 这 个 方法 的 第 一 个 int 类 型 的 参数 中 ， 我 们 设置 了 Groovy 动态 加 载 的 时 间 间 
隔 是 10 秒 ， 在 后 面 的 3 个 参数 中 ， 我 们 设置 了 Groovy 该 从 哪些 目录 中 读 取 新 增 的 过 滤器 ， 这 里 
我 们 设置 了 3 个 目录 。 

由 于 refreshZuulFilter 具有 @Bean 注解 ， 因 此 在 ZuulApp 类 运行 时 ，Spring 容器 会 自动 加 载 这 
个 方法 。 换 句 话说 ， 当 网 关 项 目 被 启动 时 ，Groovy 的 动态 加 载 机 制 就 会 生效 。 

步骤 044 准备 动态 加 载 的 过 滤器 NewPreFilterLoadedbyGroovy.groovy 是 基于 Groovy 语言 的 ， 

所 以 是 这 个 扩展 名 。 之 前 也 说 了 ，Groovy 是 基于 JVM 的 ， 所 以 它 的 语法 和 Java 无 异 ， 该 文件 的 
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代码 如 下 : 
1 package MyFilterPath.pre; 
4 import com.netflix.zuul.ZuulFilter; 
2 class NewPreFilterLoadedbyGroovy extends ZuulFilter { 
4 public Object run() { // 定 义 过 滤器 的 动作 ， 这 里 就 输出 一 句 话 
5 System.out .println("this is new added Pre Filter."); 
6 return null; 
7 } 
8 // 指 定 是 pre 类 型 的 
9 public String filterType() { 


10 return "pre"; 

EE } 

I // 指 定 优先 级 是 10 

be public int filterOrder() { 
14 return 10; 

I } 

16 // 指 定 该 过 滤器 是 生效 的 

7 public boolean shouldFilter() { 
18 return true; 

19 } 

2 


在 这 个 pre 过 滤器 中 , 我 们 重 写 了 4 个 方法 , 由 于 这 些 知 识 点 之 前 都 讲 过 , 因此 这 里 不 再 重复 。 
但 请 注意 ， 我 们 打算 在 网 关 项 目 启 动 后 ， 通 过 把 该 过 滤器 放 到 src/main/java/MyFilterPath/pre 目录 
中 实现 动态 增加 的 效果 ， 所 以 在 第 1 行 中 通过 package 指定 的 路 径 是 MyFilterPath.pre。 

至 此 ， 完 成 开发 工作 。 通 过 如 下 步骤 ， 我 们 可 以 验证 动态 增加 的 效果 。 

步骤 01 确保 NewPreFilterLoadedbyGroovy.groovy 不 在 MyFilterPath 的 本 目录 和 子 目录 下 ， 
启动 ZuulApp.javao 

步骤 02& 确保 application.yml 中 有 如 下 路 由 规则 ， 所 以 在 输入 “localhost:5555/hello” 后 会 跳 
转 到 http://www.cnblogs.com/。 


由 zuul: 
2 routes: 
， ZuulRoute: 
4 Path: /hello/** 
s url: http://www.cnblogs.com/ 
步骤 03 把 NewPreFilterLoadedbyGroovy.groovy 复制 到 MyFilterPath/pre 目录 中 ,等 待 10 秒 ， 
再 输入 “localhost:5555/hello" ， 此 时 除了 能 正常 跳 转 之 外 ， 在 控制 全 中 还 能 看 到 “this is new added 
Pre Filter.” 的 输出 ， 说 明 动 态 加 载 成 功 。 


这 里 我 们 只 给 出 了 动态 增加 pre 过 滤器 的 做 法 , 而 且 新 增 的 过 滤器 中 的 业务 逻辑 非常 简单 。 在 
实际 的 项 目 中 , 我 们 可 以 照 此 方法 动态 新 增多 种 类 型 的 过 滤器 ,同时 可 以 在 run 方法 中 实现 各 类 的 
业务 需求 。 
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7.3 通过 Zuul 实现 路 由 功能 的 实践 方案 


在 Web 应 用 中 ， 如 果 我 们 直接 将 url 请 求 发 送 到 具体 的 功能 模块 ， 这 样 不 仅 安全 性 不 高 ， 还 
会 大 大 加 重 网 站 的 维护 成 本 ， 因 为 这 样 做 ,每 个 功能 模块 不 得 不 独立 维护 一 套 url 和 对 应 服务 的 映 
射 关系 表 ， 而 且 当 服 务 数量 和 模块 数量 上 升 时 ， 映 射 表 的 维护 难度 会 大 大 增加 。 

出 于 上 述 两 点 考虑 ， 在 Web 应 用 中 ， 非 常 有 必要 在 网 关 层 实现 针对 url 的 路 由 转发 功能 ， 本 
节 将 讲述 Zuul 路 由 组 件 在 转发 请 求 方面 的 常规 做 法 。 


7.3.1 简单 路 由 的 做 法 


我 们 将 在 ZuulRouteDemo 项 目 中 实现 和 路 由 相关 的 案例 ， 有 具体 的 代码 和 视频 位 置 如 下 。 


代码 位 置 视频 位 置 


视频 第 7 章 \ 通 过 Zuul 实现 简单 路 由 


为 了 实现 路 由 功能 ， 我 们 先 做 如 下 两 项 准备 工作 。 
第 一 ， 在 pom.xml 中 ， 像 7.2 节 那 样 引入 Zuul 组 件 的 依赖 包 ， 关 键 代 码 如 下 。 


1 <dependency> 
<groupId>org.springframework.cloud</groupId> 

3 <artifactId>spring-cloud-starter-zuul</artifactId> 
4 </dependency> 


第 二 ， 创 建 名 为 ZuulAppjava 的 启动 类 ， 同 样 需 要 引入 @ EnableZuulProxy 注解 ， 代 码 如 下 。 


1 @EnableZuulProxy 

2  Q@SpringBootApplication 

3 public class ZuulApp { 

4 public static void main( String[] args ) 

5 { 

6 SpringApplication.run(ZuulApp.class, args); 
7 } 

3} 


至 此 ,完成 该 项 目的 准备 工作 。 简 单 路 由 的 做 法 比较 简单 ， 在 application.yml 中 做 相应 的 配置 
即 可 ， 相 关 的 配置 代码 如 下 。 


下 spring: 

2 application: 

六 name: zuulServer 
4 server: 

5 Port: 5555 

6 zuul: 

学 routes : 

8 ZuulRoute: 

9 path: 

0 /hello/** 
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型 url: http://www.cnblogs .com/ 


其 中 ， 前 3 行 指定 了 本 项 目的 服务 名 ， 这 和 Zuul 路 由 无 关 ， 通 过 第 4 行 和 第 5 行 的 代码 ， 我 
们 指定 了 本 项 目的 服务 端口 是 5555。 

第 6~11 行 是 配置 Zuul 路 由 信息 的 关键 ， 这 里 其 实 设置 了 zuul:route: 路 由 服务 名 :path 和 
zuul:route: 路 由 服务 名 :url 两 个 值 ， 具 体 的 说 明 如 下 。 

第 一 ， 这 里 的 路 由 服务 名 和 路 由 的 目的 路 径 无 关 ， 也 可 以 和 第 3 行 指定 的 本 项 目的 服务 名 无 
关 ， 甚 至 可 以 不 写 。 比 如 在 7.1.1 小 节 ， 我 们 就 没有 指定 ， 那 个 案例 的 相关 配置 代码 如 下 。 


1 zuul: 

2 routes: 

3 zuul-url: 
4 url: http://localhost:1111/ 


第 二 ， 通 过 path 和 url， 我 们 能 指定 路 由 路 径 和 目的 路 径 的 对 应 关系 。 比 如 在 这 里 ， 当 我 们 启 
动 ZuulRouteDemo 项 目 后 ， 输 入 “localhost:5555/hello”， 就 会 跳 转 到 http://www.cnblogs.com/。 

第 三 ， 在 上 述 第 9 行 的 path 配置 中 用 到 了 ** 通 配 符 ， 表 明 支 持 匹 配 任何 长 度 的 文字 ， 支 持 多 
级 目录 ; 此 外 ， 还 有 支持 匹配 任何 长 度 的 文字 ， 但 不 支持 多 级 目录 的 通配符 *， 以 及 只 支持 单个 文 
字 的 通配符 ?。 在 表 7.1 中 ， 我 们 详细 列 出 了 针对 这 三 类 通配符 的 用 法 。 


表 7.1 path 中 通配符 的 用 法 说 明 表 
通配符 源 url 目标 url 
出 错 ， 因 为 只 能 支持 一 个 文字 


/hello/* localhost:5555/hello/ab http://www.cnblogs.com/ab 
/hello/* localhost:5555/hello/a/b “| 出 错 ， 因 为 不 支持 多 级 目录 
/hello/** localhost:5555/hello/a/b http://www.cnblogs.com/ab 


7.3.2 ”通过 forward 跳 转 到 本 地 页 面 


Zuul 组 件 除了 能 把 url 请 求 发 送 到 对 应 的 服务 上 ， 还 可 以 通过 forward 实现 本 地 跳 转 。 比 如 ， 
当 某 个 url 被 过 滤器 判定 是 非法 请 求 时 ， 无 须 再 发 送 到 后 继 的 服务 器 上 ， 在 本 地 就 可 以 解决 ， 这 样 
可 以 大 大 减轻 后 继 服 务 器 的 负载 压力 。 

这 里 , 我 们 将 在 现 有 ZuulRouteDemo 项 目的 基础 上 , 通过 如 下 步骤 增加 forward 跳 转 的 演示 案 
例 。 


步骤 014 在 application.yml 中 ， 编 写 如 下 和 forward 相关 的 配置 代码 。 


zuul: 
routes: 

ZuulRoute: 
Path: /hello/** 
url: http://www.cnblogs.com/ 

ErrorHandle: 
Path: /error/** 
url: forward:/error 


oo vawmwwm 
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其 中 ,第 3~5 行 是 现 有 代码 ， 在 此 基础 上 ， 我 们 增加 了 第 6~8 行 的 代码 ， 其 中 设置 了 /error/** 
格式 的 url 路 径 将 被 转发 到 /error 这 个 本 地 地 址 上 。 


步 又 02 和 在 本 项 目 中 ， 新 增 一 个 名 为 ErrorHandleControllerjava 的 控制 器 类 ， 以 处 理 /error 格 
式 的 请 求 ， 关 键 代 码 如 下 。 


1 // 省 略 必要 的 package 和 import 代码 

守 @RestController 

3 Public class ErrorHandleController { 

4 @RequestMapping (value = "/error/{errorStatus}", 
method = RequestMethod.GET) 

5 Public String handleError (@PathVariable("errorStatus") 
String errorStatus){ 

6 return "Error Status is:" + errorStatus; 

J } 

1 2 


其 中 ， 在 第 2 行 中 ， 通 过 @RestController 注解 指定 了 本 类 承担 着 控制 器 的 角色 ; 在 第 4 行 中 ， 
指定 了 handleError 方法 能 处 理 /error 格式 的 url; 而 在 第 6 行 中 ， 则 定义 了 handleError 处 理 错误 的 
逻辑 ,这 里 是 简单 地 返回 了 错误 码 ， 在 实际 的 项 目 中 , 还 可 以 根据 错误 码 再 跳 转 到 不 同 的 静态 页 面 

上 。 


完成 上 述 代码 后 , 启动 ZuulRouteDemo 项 目 , 在 浏览 器 中 输入 “http://localhost:5555/error/404”， 
此 时 能 看 到 有 “Error Status is:404” 的 输出 ， 说 明 /error/404 被 跳 转 〈forward) 到 /error 的 本 地 请 求 
上 ， 且 该 请 求 被 ErrorHandleController 控制 器 中 的 handleError 方法 正确 地 处 理 了 。 


7.3.3 ”路 由 到 具体 的 服务 


在 之 前 的 案例 中 ,我 们 是 直接 路 由 (或 跳 转 ) 到 具体 的 url 上 。 而 在 之 前 讲 Eureka 和 Feign 的 
知识 点 时 ， 我 们 是 通过 服务 名 (Application Name) 来 调用 服务 的 ， 因 为 通过 服务 名 能 有 效 地 对 外 
屏蔽 服务 的 实现 细节 。 

在 Zuul 组 件 中 ， 同 样 支持 以 “serviceld” 路 由 到 具体 服务 的 功能 ， 我 们 通过 如 下 步骤 在 
ZuulRouteDemo 项 目 中 增加 这 个 功能 。 


步 又 014 由 于 这 里 是 以 Eureka 组 件 通过 服务 名 来 路 由 请 求 的 ， 因 此 在 pom.xml 中 需要 引入 
Eureka 的 依赖 包 ， 关 键 代 码 如 下 。 
<dependency> 
<groupId>org.springframework.cloud</groupId> 


<artifactId>spring-cloud-starter-zuul</artifactId> 
</dependency> 


步骤 024 在 application.yml 中 加 入 Eureka 相关 的 配置 信息 ， 关 键 代码 如 下 。 


AWDP 


1 eureka: 

2 instance: 

3 hostname: localhost 
4 client: 

5 serviceUrl: 
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6 defaultZone: http://localhost:8888/eureka/ 
加 入 Eureka 配置 的 原因 是 ， 需 要 通过 第 6 行 指定 的 defaultZone 的 路 径 来 定位 具体 的 服务 。 
步骤 034 在 application.yml 中 ， 增 加 通过 serviceld 路 由 到 具体 服务 的 配置 ， 关 键 代码 如 下 。 


于 zuul: 

加 routes: 

3 routeToServer: 

4 Path: /routeToServer/** 

号 serviceId: sayHelloServiceProvider 


其 中 ， 通 过 第 4 行 和 第 5 行 的 代码 ， 我 们 设置 格式 为 “/routeToServer/**” 的 url 将 会 被 路 由 
到 sayHelloServiceProvider 服务 上 。 

在 前 文中 提 到 ，sayHelloServiceProvider 服务 是 定义 在 FeignDemo-ServiceProvider 项 目 ( 服 务 
提供 者 项 目 ) 中 的 ， 而 该 项 目 是 注册 在 FeignDemo-Server 项 目 〈Eureka 服务 器 ) 中 的 ， 通 过 访问 
http://localhost:1111/hello/peter 这 个 url, 我 们 能 看 到 sayHelloServiceProvider 服务 的 返回 信息 是 “hello 
peter”。 

依次 启动 Eureka 服务 器 项 目 FeignDemo-Server、 服 务 提供 者 项 目 FeignDemo-ServiceProvider 
以 及 ZuulRouteDemo 项 目 ， 并 在 浏览 器 中 输入 “http://localhost:5555/routeToServer/hello/peter”， 
此 时 能 看 到 “hello peter” 的 输出 。 

从 输出 结果 中 能 看 到 , /routeToServer/ 会 被 路 由 到 sayHelloServiceProvider 服务 上 (和 配置 文件 
中 的 serviceld 定义 一 致 ) ， 而 routeToServer/hello/peter 就 相当 于 在 http://localhost:1111/ 这 个 url ( 即 
sayHelloServiceProvider 提供 服务 的 url) 后 再 加 入 “ /hello/peter ”， 这 样 最 终结 果 就 和 
http://localhost:1111/hello/peter 完全 一 致 了 。 


7.3.4 ”定义 映射 url 请 求 的 规则 


比如 有 这 样 的 场景 : 在 某 电 商 系 统 中 存在 着 诸如 合同 管理 、 客 户 管理 和 商品 管理 等 多 个 微服 
务 模块 ， 这 些微 服务 的 名 字 遵 循 着 “route- 服 务 名 -serviceProvider” 这 样 的 命名 规则 ， 比 如 提供 订单 
管理 模块 的 服务 名 叫 “route-OrderManagement-serviceProvicer”， 而 客户 管理 中 的 提供 欢迎 功能 的 
服务 名 叫 “route-sayhello-serviceProvicer”。 
这 里 的 需求 是 ， 在 网 关中 ， 我 们 需要 制定 若干 路 由 规则 ， 让 多 种 类 型 的 请 求 路 由 到 对 应 的 服 
务 模块 上 。 我 们 固然 可 以 在 配置 文件 中 针对 每 类 服务 配置 对 应 的 路 由 关系 , 但 为 了 提升 系统 的 可 维 
护 性 , 在 这 类 场景 中 , 我 们 还 可 以 自 定义 路 由 映射 规则 。 通过 如 下 步骤 , 我 们 来 演示 一 下 这 种 做 法 。 
步骤 014 更 改 FeignDemo-ServiceProvider 项 目的 application.yml 配置 文件 ， 把 其 中 该 项 目的 
服务 名 改 成 route-sayhello-serviceProvider， 关 键 代码 如 下 。 
spring: 
application: 
#name: sayHelloServiceProvider 


1 

2 

4 # for Zuul Demo 

3 name: route-sayhello-serviceProvider 
其 


中 ， 第 3 行 是 原来 的 服务 名 ， 更 新 后 的 服务 名 定义 在 第 5 行 。 
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步 又 024 在 ZuulRouteDemo 项 目的 ZuulAppjava 中 ,通过 PatternServiceRouteMapper 类 定义 
映射 关系 ， 代 码 如 下 。 


1 “// 省 略 必 要 的 package 和 import 方法 

要 @EnableZuulProxy 

号 Q@SpringBootApplication 

4 public class ZuulApp 

S| 

6 // 启 动 方法 不 变 

public static void main( String[] args ) { 

8 SpringApplication.run(ZuulApp.class, args); 
9 1 

10 // 这 个 是 新 增加 的 用 于 自 定义 规则 的 方法 

ET @Bean 

2 public PatternServiceRouteMapper myPatternServiceRouteMapper() { 
3 return new 


14 PatternServiceRouteMapper( "(route)-(?<servicename>.+) 
-(serviceProvider)","${servicename}/**"); 

i 

在 这 个 类 中 的 第 11~15 行 ， 我 们 新 增加 了 一 个 名 为 myPattermServiceRouteMapper 的 方法 。 用 
于 定义 映射 规则 的 方法 名 可 以 随便 起 ,但 需要 如 第 13 行 和 第 14 行 那样 返回 一 个 
PatternServiceRouteMapper 类 型 的 对 象 ， 同 时 需要 像 第 11 行 那样 ， 通 过 @Bean 注解 将 这 个 映射 关 
系 注册 到 Spring 容器 中 。 

在 PatternServiceRouteMapper 类 的 构造 函数 中 , 通过 两 个 参数 来 定义 映射 关系 , 这 里 会 把 格式 
是 ${servicename}/** 的 url 映射 成 route-<servicename>-serviceProvider 的 形式 。 其 中 , ${servicename} 
是 一 个 变量 。 

比如 ， 我 们 输入 “http://localhost:5555/sayhello/hello/peter”， 这 里 变量 servicename 的 值 是 
sayhello， 根 据 映 射 规则 会 把 这 个 url 映射 到 route-sayhello-serviceProvider 服务 上 ， 就 相当 于 调用 了 
该 服务 中 的 hello 方法 ， 同 时 传 入 了 “peter” 人 参数 。 

这 里 请 务必 注意 , 在 通过 正则 表达 式 组 装 PatternServiceRouteMapper 方法 第 一 个 参数 时 , 最 终 
的 结果 一 定 得 和 某 个 具体 的 服务 名 相 一 致 , 否则 第 二 个 参数 指定 的 url 就 无 法 路 由 到 对 应 的 微服 务 ， 
这 样 就 会 报 404 等 异常 。 


7.3.5 配置 路 由 的 例外 规则 


在 上 文中 我 们 定义 路 由 规则 时 ， 是 把 一 类 url 路 由 到 某 个 具体 的 服务 上 ， 但 在 实际 项 目 中 , 我 
们 需要 配置 一 些 例外 情况 。 

比如 在 下 面 的 配置 中 ， 当 路 径 中 带 有 error 时 ， 比 如 /helloBlog/error， 为 了 减轻 服务 器 的 负担 ， 
应 当 直 接 在 路 由 层 被 处 理 掉 ， 而 不 应 当 把 请 求 下 发 。 

在 ZuulRouteDemo 项 目的 application.yml 中 ， 我 们 已 经 通过 如 下 关键 代码 把 /helloBlog 的 请 求 
路 由 到 www.cnblogs.com 〈 博 客 园 ) 这 个 网 址 上 。 


于 zuul: 
2 routes: 
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3 ZuulRoute: 
4 path: /helloBlog/** 
-| url: http://www.cnblogs.com/ 


此 时 ， 我 们 可 以 通过 加 入 zuul: ignored-patterns 来 配置 路 由 的 例外 规则 ， 关 键 代码 如 下 。 


zuul: 
ignored-patterns: /helloBlog/error/** 
routes: 
ZuulRoute: 
Path: /helloBlog/** 
url: http://www.cnblogs.com/ 


2 
加 
4 
5 
6 

请 大 家 注意 第 2 行 代码 ， 这 里 我 们 是 用 ignored-patterns 设置 了 类 似 /helloBlog/error/** 格 式 的 
url 不 再 路 由 到 http://www.cnblogs.com/ 这 个 网 址 。 

完成 配置 后 ， 启 动 ZuulAppjava， 在 浏览 器 中 输入 http://localhost:5555/helloBlog/error， 这 时 就 
会 看 到 如 图 7.4 所 示 的 404 页 面 ， 说 明 配置 的 路 由 例外 规则 生效 了 。 


《 CC 个 localhost 


Whitelabel Error Page 


This application has no explicit mapping for /error, so you are seeing this as a fallback. 


Sun Jul 08 20:32:12 CST 2018 
There was an unexpected error (type=Not Found, status=404). 
No message available 


图 7.4 配置 路 由 例外 规则 后 看 到 的 404 错误 效果 图 


不 过 这 里 请 大 家 注意 ， 通 过 zuul: ignored-pattems 配置 的 路 由 例外 规则 是 全 局 性 的 ， 而 不 是 针 
对 某 个 路 由 服务 的 实例 。 所 以 ， 在 项 目 中 需要 谨慎 使 用 这 个 配置 。 


7.4 Zuul 天 然 整合 了 Ribbon 和 Hystrix 


在 大 型 应 用 系统 中 ， 我 们 往往 会 把 实现 同一 个 服务 的 代码 部 署 到 不 同 的 服务 器 上 ， 以 此 组 成 
服务 集群 ， 当 流量 比较 大 时 ， 我 们 希望 Zuul 网 关 能 以 负载 均衡 的 方式 把 请 求 分 派 到 集群 中 合适 的 
服务 器 上 ， 此 外 ， 我 们 还 希望 Zuul 网 关 层 能 实现 之 前 Hystrix 提供 的 多 种 “保护 机 制 ”。 

幸运 的 是 , 我 们 引入 Zuul 组 件 的 spring-cloud-starter-zuul 依赖 包 ， 除 了 能 提供 “路 由 ”等 功能 
外 ， 还 包含 Ribbon 和 Hystrix 的 对 应 模块 。 也 就 是 说 ，Zuul 组 件 已 经 整合 了 Ribbon 和 Hystrix。 换 
名 话说， 在 Zuul 网 关 层 ， 我 们 能 非常 方便 地 实现 负载 均衡 和 容错 保护 的 效果 。 


7.4.1 案例 的 准备 工作 


这 里 ， 我 们 将 新 建 一 个 名 为 ZuulRibbonHystrixDemo 的 项 目 ， 在 其 中 演示 Zuul 整合 Ribbon 和 
Hystrix 的 效果 ， 这 个 项 目的 准备 工作 如 下 。 
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准备 工作 1: 在 pom.xml 文件 中 ， 通 过 如 下 关键 代码 引入 Zuul 的 支持 包 。 


<dependencies> 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-zuul</artifactId> 
</dependency> 
</dependencies> 


准备 工作 2: 编写 本 项 目的 启动 类 ZuulApp.java， 在 这 个 类 中 ， 通 过 注解 实现 对 Zuul 的 支持 ， 
代码 如 下 。 这 个 类 之 前 已 经 讲解 过 ， 所 以 这 里 不 再 袭 述 。 


1 “// 省 略 必 要 的 Package 和 import 代码 
2 @EnableZuulProxy 

3  Q@SpringBootApplication 
4 public class ZuulApp 

5 { 
6 

T 

8 


MAMArnODP 


public static void main( String[] args ) 
{ SpringApplication.run(ZuulApp.class, args); } 
1 


之 后 整合 Ribbon 和 Hystrix 的 代码 就 将 在 上 述 代 码 的 基础 上 展开 。 


7.4.2 Zuul 组 件 包含 Ribbon 和 Hystrix 模块 的 依赖 


当 我 们 以 “Dependency Hierarchy” 的 方式 打开 本 项 目的 pom.xml 文件 后 ， 能 看 到 如 图 7.5 所 
示 的 效果 。 


加 ZuulRibbonHystrxDemoypomxml x 


Dependency Hierarchy 
[test] 


Filter: 


Dependeney Hieraerchy 白 国志 000 


田 


BB sprine-boot-starter-web : 1.3 5 RE] 
DD sprine-boot-starter-actuator : 1 引 
DD springrcloud-starter-hystrix : 1.1, 
) spring-cloud-starter-ribbon : 1. 
) spring-cloud-starter-archaius : 


| 
| 
中 zail-core : 1.1.0 [eonpile] | 


图 7.5 pom.xml 的 效果 图 


从 中 ， 我 们 能 看 到 引入 Zuul 依赖 包 后 ，Ribbon 和 Hystrix 的 依赖 包 也 被 自动 引入 了 。 所 以 ， 
在 后 文中 ， 我 们 基本 上 不 用 写 多 少 代 码 就 能 在 Zuul 组 件 中 使 用 这 两 个 组 件 的 特性 。 


mlm [mIm | 


图 :图 男 图- 田 


7.4.3 以 Ribbon 负载 均衡 的 方式 实现 路 由 


这 里 ， 我 们 将 重用 4.4.6 小 节 提供 的 两 个 〈 即 主 从 ) Eureka 服务 项 目 以 及 三 个 包含 sayHello 的 
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服务 提供 者 的 项 目 。 这 里 我 们 想 实现 的 效果 是 ， 当 多 个 请 求 到 达 Zuul 网 关 时 ，Zuul 能 以 负载 均衡 


的 方式 把 这 些 请 求 平均 地 下 发 到 这 三 个 服务 提供 者 的 机 器 上 。 
这 里 涉及 6 个 项 目 ， 如 表 7.2 所 示 。 


表 7.2 以 Ribbon 负载 均衡 的 方式 实现 路 由 案例 中 用 到 的 项 目 归纳 表 


项 目 名 作用 
EurekaRibbonDemo-Server Eureka 服务 器 

Eureka 服务 器 ， 和 另 一 台 相互 注册 , 以 搭建 主 从 
EurekaRibbonDemo-backup-Server 热 备 的 Eureka 服务 器 集群 


EurekaRibbonDemo-ServiceProviderOne 


EurekaRibbonDemo-ServiceProviderTwo 


向 Eureka 服务 器 注册 的 服务 提供 者 ， 这 三 台 机 
器 都 提供 了 名 为 sayHello 的 服务 

EurekaRibbonDemo-ServiceProviderThree 
实现 在 网 关中 以 负载 均衡 的 方式 下 发 请 求 的 功 


ZuulRibbonHystrixDemo 
能 


中 添加 如 下 配置 信息 。 


5 spring: 

4 application: 

3 name: zuulRibbonDemoServer 

4 server: 

5 port: 5555 

6 eureka: 

2 instance: 

8 hostname: localhost 

9 client: 

10 serviceUrl: 

了 defaultZone: http://localhost:8888/eureka/ 
12 zuul;s 

3 routes: 

14 routeToRibbonServer: 

5 path: /routeToRibbonServer/** 
16 serviceId: sayHello 


在 ZuulRibbonHystrixDemo 项 目 中 , 在 7.4.1 小节 完成 准备 工作 的 基础 上 ,我 们 在 application.yml 


其 实 这 些 配置 信息 之 前 我 们 都 讲述 过 ， 关 键 是 第 16 行 ， 这 里 serviceld 指向 的 是 sayHello， 该 


服务 包含 在 三 台 服 务 器 上 。 


我 们 依次 启动 表 7.2 所 示 的 两 台 主 从 热 备 的 Eureka 服务 器 的 项 目 、 三 个 服务 提供 者 的 项 目 以 


及 ZuulRibbonHystrixDemo 项 目 ， 随 后 在 浏览 器 中 多 次 输入 如 下 请 求 。 
1 http://localhost:5555/routeToRibbonServer/sayHello/peter 
看 到 下 面 的 三 个 返回 结果 交替 出 现 。 


能 
让 Hello Ribbon, this is Serverl, my name is:Peter 
2 
总 


Hello Ribbon, this is Server2, my name is:Peter 
Hello Ribbon, this is Server3, my name is:Peter 


从 这 个 案例 中 我 们 能 看 到 ,虽然 我 们 没有 做 额外 的 配置 , 但 由 于 Zuul 已 经 引入 了 Ribbon 依赖 


包 ， 因 此 面向 服务 集群 的 请 求 在 Zuul 网 关 层 会 被 平均 地 下 发 到 三 台 服 务 提供 者 的 机 器 上 。 
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7.4.4 在 Zuul 网 关中 引入 Hystrix 


在 前 文中 我 们 已 经 提 到 ， 当 引入 Zuul 依赖 包 的 同时 , 也 能 引入 Hystrix 特性 , 本 小 节 将 在 Zuul 
网 关中 引入 Hystrix 容错 保护 的 机 制 。 这 里 我 们 用 到 前 文中 创建 的 4 个 项 目 ， 如 表 7.3 所 示 。 


表 7.3 Zuul 网 关中 引入 Hystrix 案例 的 项 目 归纳 表 


项 目 名 作用 
EurekaRibbonDemo-Server Eureka 服务 器 
Eureka 服务 器 ， 和 另 一 台 相 互 注册 ， 以 搭建 主 从 热 备 的 


EurekaRibbonDemo-backup-Server 
中 Eureka 服务 器 集群 


EurekaRibbonDemo-ServiceProviderOne | 向 Eureka 服务 器 注册 的 服务 提供 者 ， 当 服务 启动 后 ， 我 
们 会 故意 关闭 此 项 目 ， 以 此 模式 “服务 不 可 用 ”的 效果 


ZuulRibbonHystrixDemo 在 这 个 项 目 中 加 入 基于 Hystrix 容错 保护 的 机 制 


我 们 只 用 到 了 一 个 服务 提供 者 ， 而 和 Hystrix 相关 的 代码 是 写 在 ZuulRibbonHystrixDemo 项 目 
中 的 。 有 具体 的 实现 步骤 如 下 。 

步骤 014 在 原 项 目的 基础 上 新 增 一 个 基于 Hystrix 实现 保护 机 制 的 类 
ZuulFallBackDemo.java， 代 码 如 下 。 


1 “// 省 略 必要 的 package 和 import 代码 

2 public class ZuulFallbackDemo implements ZuulFallbackProvider { 
2 public ClientHttpResponse fallbackResponse() { 

4 return new ClientHttpResponse(){ 

; Public InputStream getBody () throws IOException { 

6 String retVal = "return by Hystrix"; 

池 return new BYyteRArrayInputStream(retVal.getBytes ()) 7 
8 } 

9 public HttpHeaders getHeaders() { 

10 HttpHeaders headers = new HttpHeaders(); 

31 return headers; 

32 } 

人 Public HttpStatus getStatusCode() throws IOException { 
14 return HttpStatus.OK; 

15 } 

16 public int getRawStatusCode() throws IOException { 
I return HttpStatus.OK.value(); 

18 } 

19 public String getStatusText() throws IOException { 
20 return HttpStatus .OK.getReasonPhrase (); 

21 } 

22 Public void close() { } 

23 ] 7 

24 } 

25 // 指 定 针对 哪个 服务 生效 

26 public String getRoute() { 

2 return "sayHello"; 

28 


9 
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在 这 个 类 中 ， 我们 需要 如 第 2 行 所 示 实 现 (implements) ZuulFallbackProvider 接口 ， 同 时 如 第 
3 行 所 示 重 写 ClientHttpResponse 方法 。 
在 第 4 行 中 , 我们 新 建 并 返回 了 一 个 ClientHttpResponse 类 型 的 对 象 。 在 后 继 的 第 5~23 行 中 ， 
我 们 重 写 了 ClientHttpResponse 类 的 诸多 方法 。 
从 第 5 行 的 getBody 方法 中 , 我 们 定义 了 一 旦 出 错 则 需要 返回 的 流 对 象 , 这 里 是 返回 “retum by 
Hystrix”; 在 第 9 行 的 getHeaders 方法 中 ， 我 们 定义 了 一 旦 出 错 则 需要 返回 的 http 头 ， 这 里 是 一 
个 新 建 出 来 的 空 对 象 ; 在 第 13~21 行 的 三 个 方法 中 ， 我 们 分 别 定义 了 一 旦 服务 不 可 用 时 需要 返回 
的 状态 码 ， 一 般 来 说 ， 哪 怕 服 务 不 可 用 ， 常 规 的 做 法 是 提示 出 错 信息 或 者 跳 转 到 出 错 页 面 ， 所 以 一 
般 都 是 返回 200 状态 码 ， 即 如 第 14 行 所 示 的 HttpStatus.OK; 在 第 22 行 的 close 方法 中 ， 我 们 一 般 
是 不 做 任何 操作 的 。 

而 在 第 26 行 的 getRoute 方法 中 ， 我 们 定义 了 该 熔断 保护 措施 是 对 哪个 服务 生效 的 ， 这 里 是 
sayHello。 我 们 也 可 以 把 第 26 行 的 代码 改 成 returm "*";， 这 样 就 针对 所 有 的 服务 都 生效 了 。 

步骤 024 在 启动 类 中 ， 通 过 @Bean 的 注解 向 Spring 容器 注入 ZuulFallbackDemo 类 ， 否 则 上 

述 熔断 保护 措施 无 法 生效 ， 代 码 如 下 。 


1 “// 省 略 必要 的 package 和 import 代码 

2 Q@EnableZuulProxy 

3  Q@SpringBootApplication 

4 public class ZuulApp 

31 

6 /1 引入 Hystrix 熔断 保护 类 

7 @Bean 

8 public ZuulFallbackDemo myHystrixDemo(){ 

9 return new ZuulFallbackDemo(); 

10 } 

11 // 正 常 的 启动 方法 

人 2 Public static void main( String[] args ) { 
3 SpringApplication.run(ZuulApp.class, args); 
14 } 

Ls 


按 上 述 两 步 完 成 开发 后 ， 如 表 7.3 所 示 ， 我 们 依次 启动 两 个 Eureka 服务 器 项 目 、 一 个 服务 提 
供 者 项 目 和 ZuulRibbonHystrixDemo 项 目 ， 随 后 在 浏览 器 中 输入 如 下 url。 

1 http://localhost:5555/routeToRibbonServer/sayHello/Peter 

此 时 ,能 看 到 正常 的 输出 。 随 后 ， 我 们 可 以 关闭 EurekaRibbonDemo-ServiceProviderOne 项 目 ， 
这 样 sayHello 服务 就 不 可 用 了 。 这 时 再 次 访问 上 述 的 url， 就 能 看 到 如 下 结果 。 

1 return by Hystrix 

这 就 说 明 ， 当 被 请 求 的 服务 处 于 不 可 用 状态 时 ，Zuul 组 件 会 自动 触发 Hystrix 中 的 回 退 

(fallback) 机 制 ， 即 通过 getBody() 方 法 返回 事先 设置 好 的 一 段 文字 。 
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7.5 本 章 小 结 


本 章 在 介绍 Zuul 基本 功能 的 前 提 下 , 详细 给 出 了 Zuul 常用 的 4 种 过 滤器 的 用 法 , 尤其 讲述 了 
通过 error 过 滤器 输出 异常 信息 和 出 错 提示 界面 的 做 法 。 

此 外 ， 本 章 着 重 讲 述 了 Zuul 的 本 职工 作 一 一 路 由 。 具 体 而 言 ， 通 过 案例 讲述 了 简单 路 由 、 自 
定义 规则 路 由 和 动态 路 由 的 做 法 ， 并 在 此 基础 上 让 Zuul 整合 了 Ribbon 和 Hystrix 组 件 。 

通过 本 章 的 学 习 ， 大 家 除了 可 以 了 解 Zuul 组 件 的 用 法 外 ， 还 能 在 架构 级 别 对 网 关 的 功能 和 各 
种 配置 有 比较 直观 的 认识 ， 这 对 大 家 掌握 架构 师 级 别 的 技能 大 有 帮助 。 


第 8 章 


用 Spring Cloud Config 搭建 配置 中 心 


在 实际 的 应 用 项 目 中 , 我 们 一 般 会 用 多 个 基于 Spring Cloud 的 微服 务 功能 组 件 搭建 成 一 个 分 布 
式 应 用 。 通 过 之 前 的 学 习 ， 我 们 已 经 可 以 看 到 每 个 组 件 一 般 都 会 在 application.yml 中 包含 自己 的 配 
置 文件 ， 换 名 话说 ,在 之 前 的 做 法 中 , 配置 文件 是 由 每 个 项 目 组 自己 来 维护 的 , 但 这 不 是 推荐 的 做 
法 。 

在 实际 项 目 中 ， 所 有 产生 的 配置 文件 将 会 被 配置 中 心 统一 管理 ， 这 样 不 仅 可 以 降低 出 错 的 风 
险 ， 还 能 避免 一 些 重复 乃至 相互 冲突 的 配置 。 在 Spring Cloud 体系 中 ， 可 以 用 Spring Cloud Config 
组 件 来 搭建 项 目的 配置 中 心 。 


8.1 通过 Spring Cloud Config 搭 建 基 于 Git 的 配置 中 心 


在 项 目 中 ， 配 置 中 心 主要 负责 三 方面 的 工作 : 第 一 ， 以 Git 或 SVN 版 本 管理 的 形式 统一 管理 
多 个 功能 模块 中 的 配置 信息 ; 第 二 ， 能 让 应 用 程序 简单 高 效 地 获取 配置 信息 ; 第 三 , 能 自动 加 载 变 
更 后 的 配置 信息 ， 从 而 让 修改 后 的 配置 信息 快速 生效 。 

在 基于 Spring Cloud 微服 务 的 项 目 中 , 一 般 会 用 Spring Cloud Config 来 搭建 配置 中 心 。 本 节 将 
把 配置 文件 写 入 Git 服务 器 中 ， 在 应 用 项 目 中 通过 Spring Cloud Config 服务 器 和 客户 端 来 读 取 具体 
的 配置 值 。 


8.1.1 Spring Cloud Config 中 服务 器 和 客户 端的 体系 结构 


在 基于 Spring Cloud Config 组 件 的 配置 中 心中 有 配置 服务 器 和 配置 客户 端 两 种 角色 。 其 中 , 一 
个 项 目 中 往往 会 有 一 个 配置 服务 器 ， 它 主要 负责 从 Git 或 SVN 服务 器 上 获取 配置 信息 ， 如 果 有 需 
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要 的 话 ， 项 目 中 每 个 功能 模块 会 包含 一 个 配置 客户 端 ， 客 户 端 会 从 服务 器 中 读 取 配置 信息 ， 大 致 的 


体系 结构 如 图 8.1 所 示 。 
读 取 配置 | 读 取 配置 的 客户 端 
《功能 模块 1) 


读 取 配置 的 客户 端 
《功能 模块 2) 


读 取 配 置 
图 8.1 Spring Cloud Config 的 体系 结构 


我 们 一 般 会 把 包含 配置 信息 的 Git 或 SVN 仓库 、 配 置 服务 器 和 配置 客户 端 统称 为 配置 中 心 ( 基 
于 Spring Cloud Config) 。 在 后 文中 ， 我 们 将 通过 具体 的 案例 进一步 向 大 家 展示 服务 器 和 客户 端的 
具体 功能 和 常见 用 法 。 


8.1.2 ”在 Git 上 准备 配置 文件 


大 多 数 公司 一 般 会 搭建 自己 的 Git 服务 器 ， 用 来 存放 配置 信息 。 本 小 节 的 讲述 重点 是 Spring 
Cloud Config 配置 中 心 , 简单 地 把 配置 文件 放 在 https://coding.net 代码 托管 网 站 的 Git 仓库 里 , 具体 
的 准备 工作 如 下 。 


步 台 01 在 https://coding.net 网 站 上 完成 注册 、 登 录 等 动作 后 , 创建 名 为 springcloudGitProject 
的 项 目 。 
步骤 024 在 该 项 目 中 创建 一 个 名 为 master 的 分 支 ， 并 设置 成 “Git” 管 理 模式 。 
步骤 034 在 该 master 分 支 中 创建 一 个 名 为 git-prod.properties 的 配置 文件 ,并 在 其 中 输入 如 下 
配置 信息 。 
1 Pprod.hello = prod 


2 prod.url = localhost 
3 prod.port = 3306 


步骤 044 得 到 如 下 指向 master 分 支 的 Git 链接 ， 以 便 在 Spring Cloud Config 配置 中 心 用 到 。 
1 https://git.coding.net/hsm computer/springcloudGitProject.git 
由 于 本 章 的 关注 点 在 于 Spring Cloud Config 配置 中 心 ， 因 此 在 这 里 没有 详细 给 出 在 
https://coding.net 网 站 中 创建 项 目 、 分 支 以 及 Git 配置 的 详细 步骤 ,不 过 在 本 书 附带 的 视频 中 ， 大 家 
可 以 看 到 详细 的 操作 步骤 。 
至 此 , 我 们 完成 了 Git 仓库 的 准备 工作 。 接 下 来 就 可 以 在 配置 中 心中 连接 并 读 取 其 中 的 配置 信 
息 了 。 
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8.1.3 在 服务 器 中 连接 Git 仓库 


在 Spring Cloud Config 配置 中 心 的 服务 器 中 ， 我 们 将 连接 Git 仓库 ， 如 果 Git 仓库 不 是 在 本 地 
(比如 本 小 节 的 案例 ) ， 通 过 服务 器 还 能 把 配置 文件 下 载 到 本 地 。 
在 GitConfigServer 项 目 中 ， 我 们 将 演示 开发 Spring Cloud Config 配置 中 心 的 服务 器 的 一 般 步 
又 ， 从 中 大 家 能 够 体会 到 服务 器 在 配置 中 心 的 作用 。 
代码 位 置 视频 位 置 
代码 \ 第 8 章 \GitConfigServer 视频 \ 第 8 章 \SpringCloudConfig 连接 Git 仓库 


步 又 014 在 pom.xml 中 引入 Spring Cloud Config 服务 器 的 依赖 包 ， 关 键 代码 如 下 。 该 pom 
文件 的 所 有 代码 ， 大 家 可 以 参考 本 书 附 带 的 项 目 代码 。 


1 <dependency> 
<groupId>org.springframework.cloud</groupId> 

号 <artifactId>spring-cloud-config-server</artifactId> 
4 </dependency> 


步 又 024 编写 启动 类 ConfigServerApp， 代 码 如 下 。 
// 省 略 必 要 的 package 和 import 代码 


@EnableConfigServer 
@SpringBootApplication 
public class ConfigServerApp{ 
Public static void main( String[] args ){ 
SpringApplication.run(ConfigServerApp.class, args); 
} 


o auwmcewNP 


在 第 2 行 中 ， 我 们 通过 @EnableConfigServer 注解 来 指定 该 项 目 具有 Spring Cloud Config 
配置 中 心服 务 器 的 作用 。 


步骤 034 通过 application.yml 文件 指定 Git 仓库 的 配置 ， 代 码 如 下 。 


server: 

2 Portr 5506 

3 ‘spring: 

4 application: 

BS] name: SpringCloudConfigGitServer 

6 cloud: 

了 config: 

8 server: 

9 SLEs 

10 uri: https://git.coding.net/hsm computer/ 
springcloudGitProject.git 

ER clone-on-start: true 


其 中 ， 我 们 通过 第 1 行 和 第 2 行 代码 指定 Spring Cloud Config 服务 器 工作 在 5566 端口 ， 通 过 
第 5 行 代码 指定 该 服务 器 的 名 字 。 请 注意 ， 这 里 服务 器 的 名 字 可 以 随便 起 ， 和 Git 仓库 配置 之 问 没 
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有 关系 。 

关键 是 第 10 行 ， 通 过 spring.cloud.config.git.uri 的 形式 指定 本 服务 器 需要 指向 的 Git 仓库 的 路 
径 ， 这 里 需要 和 8.1.2 小 节 https://coding.net 网 站 上 的 Git 路 径 一 致 。 

在 默认 情况 下 ， 当 Git 仓库 中 的 配置 被 第 一 次 请 求 时 ，Spring Cloud Config 服务 器 才 会 克隆 远 
端 Git 仓库 中 的 配置 ， 即 在 本 地 保存 一 份 远 端 Git 仓库 中 的 配置 。 如 果 我 们 像 第 11 行 那样 指定 了 
clone-on-start 属性 是 true， 就 会 在 本 服务 被 启动 时 克隆 远 端的 配置 文件 。 

至 此 ， 完 成 开发 工作 。 通 过 ConigServerApp 类 启动 项 目 后 ， 能 在 控制 台中 看 到 如 图 8.2 所 示 
的 效果 ， 其 中 能 看 到 诸如 /Mapped "{[/{label}/{name}-{profiles}.json],methods=[GET]} 等 的 映射 
Mapping 关系 。 


Mapping : Mapped /dc ero name}/{profiles}],methods=[{POST)}" onto public java.lang.Sstr. 
abe ng : Mapped "ff methods=[GET]}" java.lang.Str. 交 springframework 
: Mapped "ff Y， /tn }/ {pr ] S™ ET] }" onto 

Mapping : Mapped " 
Mapping : Mapped " 
Mapping : Mapped [ 
Mapping : Mapped " 1 3。 " onto public org.sp 
Mapping : Mapped 1 1: Ne ]}" onto public org.sp 
Mapping : Mapped i 
Mapping : Mapped 
Mapping : Mapped ] 
Mapping : Mapped " 1 name } — {prori .yml 1 ame}-{profiles} .yami], 
Mapping : Mapped ile} bel}/**] ,methods: Produces=[application/octe 
Mapping : Mapped "{[/{nam ile}/{label}/**] ,methods: }" onto public java.lang.St: 


图 8.2 启动 Spring Cloud Config 服务 器 后 能 看 到 的 Mapping 映射 示意 效果 图 
从 图 8.2 我 们 能 看 到 通过 服务 器 的 url 读 取 保存 在 Git 仓库 中 配置 文件 的 各 种 方法 。 
方法 一 : 在 浏览 器 中 输入 “http://localhost:5566/master/git-prodjson”， 能 看 到 如 下 输出 ， 这 和 
我 们 在 Git 仓库 中 配置 的 git-prod.properties 信息 是 一 致 的 。 
1 Uprod":l"hello" prod" "port "30 UL localhost" yy 


我 们 来 分 析 一 下 url 的 格式 ， 其 中 5566 是 本 服务 器 工作 的 端口 号 ， 这 个 需要 和 application.yml 
中 配置 的 server.port 内 容 一 致 。 从 上 文中 ， 我 们 看 到 了 可 以 通过 “/{label}/{name}- {profiles}.json” 
的 形式 来 访问 配置 ,其 中 label 在 Git 的 场景 中 ,一 般 表示 Git 的 分 支 ,这 里 是 master, 而 name- profiles 
分 别 对 应 于 配置 文件 名 中 的 git-prod, 也 就 是 说 在 这 个 场景 中 , name 是 “git”, 而 profiles 是 “prod”。 

方法 二 : 通过 /{label}/{name}-{profiles}.yml 的 形式 来 访问 配置 文件 ， 具 体 是 输入 
“http://localhost:5566/master/git-prod.yml”， 可 以 看 到 如 下 yml 格式 的 输出 。 


3 
时 


1 prod: 

4 hello: prod 

3 Ports "3306" 
4 url: localhost 


方法 三 : 通过 /{name}/{profile}/{label}/** 的 形式 来 访问 ， 我 们 可 以 把 name、profiles 和 lable 
分 别 改 成 相应 的 值 ， 即 http://localhost:5566/git/prod/master， 通 过 这 个 url 可 以 看 到 配置 信息 。 

此 外 , 我们 还 可 以 依照 如 图 8.2 所 示 的 启动 时 控制 台 提 示 的 其 他 映射 方式 来 查看 配置 信息 。 需 
要 说 明 的 是 ， 我 们 在 服务 器 中 通过 各 种 url 查看 配置 信息 仅仅 是 验证 服务 器 是 否 正 确 地 连 上 Git 仓 
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库 。 在 一 般 项 目的 配置 中 心服 务 器 中 ,我 们 不 大 会 直接 使 用 配置 信息 ， 事 实 上 服务 器 的 作用 是 绑 定 
并 获取 Git 仓库 中 的 配置 文件 ， 供 配置 中 心 的 各 个 客户 端 使 用 。 


8.1.4 在 客户 端 读 取 配 置 文件 


在 GitConfigClient 项 目 中 ， 我 们 将 演示 在 客户 端 如 何 读 取 配置 文件 的 一 般 做 法 。 


代码 位 置 视频 位 置 
代码 \ 第 8 章 \GitConfigClient 视频 \ 第 8 章 \SpringCloud 在 客户 端 读 取 配 置 文件 
步骤 014 在 pom.xml 中 引入 Spring Boot 和 Spring Cloud Config 的 依赖 包 ， 关 键 代 码 如 下 。 
<dependencies> 
2 <dependency> 
六 <groupId>org.springframework.cloud</groupId> 
4 <artifactId>spring-cloud-starter-config</artifactId> 
5 </dependency> 
6 <dependency> 
7 <groupId>org.springframework.boot</groupId> 
8 <artifactId>spring-boot-starter-web</artifactId> 
9 <version>1.5.4.RELEASE</version> 
10 </dependency> 


11 </dependencies> 

由 于 在 本 项 目 中 我 们 会 创建 一 个 控制 器 类 ， 并 在 其 中 提供 对 外 服务 的 方法 ， 因 此 需要 引入 
Spring Boot 的 依赖 包 。 

步骤 02& 在 bootstrap.yml 文件 中 ， 通 过 如 下 配置 连 上 配置 中 心 的 服务 器 ， 从 而 可 以 得 到 Git 
仓库 中 的 配置 信息 ， 代 码 如 下 。 


5 server: 

2 por Ss77 

3 spring: 

4 application: 

3 name: git 

6 cloud: 

了 config: 

8 profile: prod 
9 label: master 
0 uri: http://localhost:5566 
11 management: 

2 security: 

33 enabled: false 


其 中 , 通过 第 2 行 代 码 指定 了 本 服务 的 工作 端口 是 5577; 在 第 13 行 指 定 了 连接 时 无 须 安全 验 
证 ;而 第 5 行 、 第 8 行 、 第 9 行 和 第 10 行 的 参数 值 需要 按 如 下 方式 指定 。 

e@ spring.application.name 的 值 需要 和 服务 器 中 fname} 的 值 一 致 ， 这 里 是 git。 

espring.config.profile 的 值 需 要 和 {profiles} 一 致 ， 这 里 是 prod。 

@ spring.config.label 的 值 需要 和 {label} 一 致 ， 这 里 是 master。 
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请 大 家 务必 注意 上 述 规则 ， 和 否则 无 法 成 功 地 让 客户 端 连接 到 服务 器 。 

还 有 一 个 细节 请 大 家 注意 ， 这 里 我 们 不 是 像 往常 那样 把 上 述 配置 文件 写 入 application.yml， 而 
是 写 入 bootstrap.yml。 大 家 可 以 尝试 一 下 ， 如 果 把 配置 文件 写 入 application.yml， 就 无 法 连接 配置 
中 心 的 服务 器 了 。 原 因 是 ， 在 启动 这 个 Spring Cloud 项 目 时 ， 我 们 就 应 该 让 Spring Cloud Config 的 
配置 中 心 根据 相关 信息 进行 关联 操作 ， 而 启动 时 不 会 加 载 application.yml， 从 而 无 法 读 到 其 中 的 配 
置 ， 但 会 加 载 bootstrap.yml。 


步 最 034 编写 启动 类 ， 代 码 如 下 。 这 部 分 代码 我 们 经 常用 到 ， 所 以 就 不 讲解 了 。 


1 ，“// 省 略 必 要 的 Package 和 import 代码 

2  @SpringBootApplication 

3 public class ConigClientApp { 

4 public static void main( String[] args ) { 

5 SpringApplication.run(ConigClientApp.class, args); 
6 } 
KE 


步骤 044 编写 一 个 能 提供 对 外 服务 的 Controller 类 ， 代 码 如 下 。 


1 ，“// 省 略 必要 的 package 和 import 代码 

2 “6@RestController 

3 public class Controller { 

4 @Autowired 

5S Private Environment env; 

6 @RequestMapping (value = "/getConfig", method = RequestMethod.GET) 
br public String getConfig() { 

8 // 通 过 env 对 象 分 别 得 到 3 个 配置 

9 String helloStr = env.getProperty("Prod.hel1lo") 
10 String UrlStr = enV.getProperty("Prod.ur1l") 

二 String PortStr = env.getProperty("Prod.Port") 7 

12 // 拼 装 并 返回 3 个 配置 

13 return helloStz + “Non + urlstr + "\n™ + portStrs 
14 } 

5 


在 第 5 行 代码 中 ， 我 们 通过 @Autowired 引入 了 一 个 env 对 象 ; 在 第 7~14 行 的 getConfig 方法 
中 ， 我 们 通过 这 个 env 对 象 在 第 9~11 行 读 取 到 了 git 仓库 里 git-prod.properties 文件 中 的 三 个 配置 ， 
并 在 第 13 行 组 装 后 返回 。 

启动 该 类 后 ,同时 确保 服务 器 项 目 处 于 启动 状态 , 然后 输入 “http://localhost:5577/getConfig”， 
这 时 能 看 到 输出 内 容 “prod localhost 3306”， 说 明 在 配置 中 心 的 客户 端 中 能 通过 服务 器 正确 地 得 到 
配置 信息 。 


8.2 搭建 基于 SVN 的 配置 中 心 


前 面 我 们 讲述 了 配置 中 心 连接 Git 仓库 的 方式 ， 本 节 将 连接 远程 SVN 以 得 到 配置 信息 。 通 过 
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这 个 案例 ， 我 们 能 进一步 理解 配置 中 心 的 服务 器 和 客户 端 角色 。 


8.2.1 准备 SVN 环境 


SVN 是 Subversion 的 缩写 ， 和 Git 一样， 是 一 种 版 本 管理 工具 。 在 使 用 过 程 中 ，SVN 一 般 分 
服务 器 和 客户 端 两 种 , 在 这 个 案例 中 , 我 们 依然 把 SVN 的 相关 配置 放 在 https://coding.net 代码 托管 
网 站 上 。 也 就 是 说 ， 该 网 站 承担 了 SVN 服务 器 的 角色 ， 而 在 本 地 则 采用 了 TortoiseSVN 作为 SVN 
客户 端 。 通 过 如 下 步骤 ， 我 们 能 完成 SVN 环境 的 准备 工作 。 

步骤 014 在 https://coding.net 上 ， 用 SVN 的 方式 新 建 一 个 名 为 PropertiesBySVN 的 项 目 ， 并 
根据 常见 的 SVN 目录 规则 创建 如 图 8.3 所 示 的 目录 。 


SN ETTTRRTTTTTRTTTOTTTTTTRITST 


仓库 文件 
和 branches 
和 trunk 


和 tags 


8.3 在 SVN 服务 器 上 创建 的 目录 结构 示意 图 


步 又 024h 在 本 地 正确 安装 好 TortoiseSVN 软件 后 ， 新 建 一 个 目录 来 存放 相关 配置 信息 。 这 里 
我 们 是 在 Di\svn\PropertiessBySVN\master 目录 中 创建 svn-dev.properties 和 svn-prod.properties 两 个 配 
置 文件 。 在 前 者 写 入 “dev.maxConnection=100”"， 在 后 者 写 入 “prod.maxConnection=200”。 

步骤 03 A 通过 TortoiseSVN 把 上 述 两 个 配置 文件 提交 ( commit ) 到 https://coding.netwang 代 
码 托管 的 网 站 中 。 这 里 关于 SVN 的 操作 不 详细 讲解 ， 但 会 录制 在 视频 中 ， 如 果 有 问题 ， 大 家 可 以 
人 参考。 正确 操作 完成 后 ，svn-prod.properties 和 svn-dev.properties 两 个 配置 文件 会 被 正确 地 提交 到 如 
图 8.4 所 示 的 目录 中 。 


SVN Y svn://subversion.coding.net/hsm_computer/PropertiesBySVN 


PropertiesBySVN / branches / master 


仓库 文件 
口 svn-prod,properties 


口 svn-devproperties 


图 8.4 两 个 配置 文件 在 SVN 服务 器 中 相关 位 置 的 示意 图 
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从 图 8.4 的 上 方 ， 我 们 能 够 看 到 SVN 仓库 的 uri 路 径 ， 在 Spring Cloud Config 配置 服务 器 的 
application.yml 中 ， 我 们 需要 正确 地 设置 这 个 uri。 


8.2.2 ”编写 基于 SVN 的 配置 服务 器 代码 


在 SVNConfigServer 项 目 中 ， 我 们 将 演示 基于 SVN 的 配置 中 心服 务 器 的 开发 步骤 。 


代码 位 置 视频 位 置 
代码 \ 第 8 章 \SVNConfigServer 视频 第 8 章 \SpringCloud 编写 基于 SVN 的 配置 服务 器 


步 又 014 在 该 项 目的 pom.xml 文件 中 引入 Spring Cloud Config 服务 器 和 SVN 的 依赖 包 ， 关 


键 代 码 如 下 。 其 中 ， 第 1~4 行 引入 了 Spring Cloud Config Server 的 依赖 包 ， 第 5~9 行 引入 了 SVN 
依赖 包 。 


<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-config-server</artifactId> 
</dependency> 
<dependency> 
<groupId>org.tmatesoft.svnkit</groupId> 
<artifactId>svnkit</artifactId> 
<version>1.7.5</version> 
</dependency> 


步 最 024 在 application.yml 中 编写 连接 SVN 服务 器 的 配置 ， 代 码 如 下 。 


Server: 
port: 5566 
spring: 
application: 
name: SpringCloudConfigSVNServer 
profiles: 
active: subversion 
cloud: 
config: 
10 server: 
ul svn: 
和 uri: svn://subversion.coding.net/hsm computer/ 
PropertiesBySVN/branches 


oaowmwwN 


oawm 必 wm 


其 中 , 在 第 2 行 指 定 了 该 配置 服务 器 的 工作 端口 是 5566, 在 第 5 行 中 指定 了 该 项 目的 服务 名 。 
在 第 7 行 中 通过 spring.profiles.active 的 形式 指定 了 连接 方式 是 subversion( 即 SVN )。 在 Spring Cloud 
Config 中 ， 该 属性 的 默认 值 是 Git， 所 以 在 之 前 的 Git 案例 中 ， 我 们 无 须 配置 该 属性 的 值 。 在 第 12 
行 中 ， 通 过 cloud.config.server.svn.uri 的 形式 指定 了 SVN 服务 器 的 路 径 ， 这 个 值 需 要 和 在 
https://coding.net 中 设置 的 一 致 。 


步骤 03 编写 Spring Cloud Config 服务 器 的 启动 类 ConfigServerApp， 代 码 如 下 。 


1 “// 省 略 必 要 的 package 和 import 代码 
多 @EnableConfigServer 
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3  Q@SpringBootApplication 

4 public class ConfigServerApp{ 

六 public static void main( String[] args ) { 

6 SpringApplication.run(ConfigServerApp.class, args); 
7 } 

8 


L 

这 和 Git 案例 中 的 启动 类 完全 一 致 , 同样 需要 加 上 如 第 2 行 所 示 的 @ EnableConfigServer 注解 。 

该 类 建议 用 JDK1.8 编译 和 启动 ,启动 后 ,输入 “http://localhost:5566/master/svn-prod.properties”， 
则 能 看 到 如 下 输出 。 

i Prod.maxConnection: 200 

这 说 明 ， 该 配置 服务 器 成 功 地 连 上 了 SVN 服务 器 。 而 且 ， 我 们 能 看 到 ， 配 置 服务 器 连接 SVN 
和 Git 的 方式 非常 相似 ， 只 是 稍微 修改 了 application.yml 中 的 相关 配置 。 从 中 我 们 能 看 到 ， 配 置 服 
务 器 可 以 向 具体 使 用 配置 信息 的 客户 端 屏蔽 配置 信息 的 存储 和 管理 方式 , 在 后 文 的 描述 中 , 大 家 可 
以 直观 地 体会 到 这 点 。 


8.2.3 在 应 用 中 读 取 基于 SVN 客户 端的 配置 


在 SVNConfigClient 项 目 中， 我 们 将 通过 配置 服务 器 读 取 SVN 服务 器 中 的 配置 文件 。 


代码 位 置 视频 位 置 


代码 \ 第 8 章 \SVNConfigClient 视频 \ 第 8 章 \ 在 应 用 中 读 取 SVN 客户 端的 配置 


该 项 目 是 根据 之 前 的 GitConfigClient 项 目 改写 而 成 的 ， 它 们 之 间 有 如 下 区 别 。 
区 别 点 1: bootstrap.yml 中 的 配置 信息 有 所 不 同 。 


王 server: 

4 Ports 5577 

3 spring: 

4 application: 

5 name: svn 

6 cloud: 

7 config: 

8 Profile: prod 
9 label: master 
10 uri: http://localhost:5566 
11 management: 

12 Security: 

13 enabled: false 


同样 ， 这 里 需要 把 针对 SVN 服务 器 的 连接 信息 写 到 bootstrap.yml 中 ， 而 不 是 application.yml 
中 。 在 8.2.2 小 节 , 我 们 是 通过 “/{label}/{name}-{profiles} .properties”( 即 /master/svn-prod.properties) 
的 形式 来 访问 基于 SVN 的 配置 的 ,根据 8.1.4 小 节 描 述 的 规则 ,我 们 在 上 述 文件 中 填 入 了 相关 内 容 ， 
有 具体 如 下 。 

第 5 行 的 spring.application.name 的 值 需要 和 服务 器 中 {name} 的 值 一 臻 ， 这 里 是 svn。 

第 8 行 的 spring.config.profile 的 值 需要 和 {profiles} 一致 ， 这 里 是 prod。 

第 9 行 的 spring.config.label 的 值 需要 和 {label} 一 致 ， 这 里 是 master。 
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第 10 行 的 spring.config.uri 是 服务 器 的 路 径 。 

区 别 点 2: 我 们 改写 了 控制 器 类 Controllerjava， 代 码 如 下 。 
1 // 省 略 必要 的 package 和 import 代码 

2 @RestController 

3 public class Controller { 

4 / /同样 是 通过 env 来 获取 配置 的 
5 @Autowired 

6 Private Environment env; 
7 @RequestMapping (value = "/getConfigBySvn", method = RequestMethod.GET 
) 

8 

9 

灿 


Public String getConfig() { 
return enV.getProperty("Prod.maxConnection") 
0 } 

在 第 8 行 中 ， 我 们 提供 了 针对 /getConfigBySvn 请 求 的 getConfig 方法 ; 在 第 9 行 中 ,， 我们 通过 
env 得 到 存储 在 SVN 服务 器 中 的 配置 信息 。 

启动 配置 中 心 的 服务 器 和 客户 端 ,然后 在 浏览 器 中 输入 “http://localhost:5577/getConfigBySvn”， 
则 能 看 到 prod.maxConnection 的 属性 值 (200) 。 这 说 明 ， 在 客户 端 中 ， 我 们 成 功 地 得 到 了 SVN 的 
配置 信息 。 


8.3 ”服务 器 和 客户 端的 其 他 常见 用 法 


前 面 我 们 以 Git 和 SVN 远 端 仓库 为 例 演示 了 Spring Cloud Config 服务 器 和 客户 端的 基本 用 法 ， 
本 节 将 演示 在 实际 项 目 中 针对 配置 中 心 的 其 他 常见 操作 。 

需要 说 明 的 是 ，Spring Cloud Config 服务 器 除了 支持 从 Git 或 SVN 服务 器 上 读 取 配置 文件 外 ， 
还 可 以 从 本 地 指定 的 路 径 中 读 取 , 但 在 项 目 中 往往 会 用 版 本 管理 的 方式 来 管理 , 所 以 很 少 采 用 这 种 
方式 。 本 章 不 浪费 篇 幅 讲述 从 本 地 路 径 中 读 取 配 置 的 开发 方式 。 


8.3.1 总 结 配置 客户 端 和 服务 器 的 作用 


我 们 采用 逆向 思维 的 方式 ， 首 先 看 一 下 ,如 果 没有 Spring Cloud Config 客户 端 ， 那 么 会 带 来 哪 
些 不 便 ? 

第 一 ， 我 们 不 得 不 在 微服 务 架构 中 自己 写 一 套 连接 并 获取 配置 文件 的 方式 ， 包 括 连接 Git (或 
SVN) 服务 器 ， 并 从 中 得 到 指定 的 配置 ， 这 部 分 代码 其 实 是 和 微服 务 架构 无 关 的 。 

换 句 话说 ， 通 过 配置 客户 端 ， 我 们 能 以 一 种 简单 的 方式 〈 比 如 写 bootstrap.yml 文件 ) 从 配置 
服务 器 中 得 到 配置 ， 同 时 无 颖 地 把 这 些 配置 写 入 Spring 上 下 文 容器 。 

第 二 ， 如 果 没 有 配置 客户 端 ， 一 旦 配置 文件 发 生变 更 ， 我 们 就 得 通过 重启 服务 等 方式 手动 地 
加 载 它们 。 在 后 文中 ， 我 们 能 看 到 ， 通 过 客户 端 ， 当 配置 变更 时 ， 加 载 方式 将 会 变 得 比较 简洁 。 

同样 的 ， 如 果 没 有 配置 服务 器 ， 项 目 中 多 个 模块 就 可 能 各 自 管理 自己 的 配置 文件 ， 这 样 就 会 
加 大 项 目 运 行 维护 的 成 本 ， 而 配置 服务 器 通过 绑 定 一 个 〈 或 多 个 ) 配置 源 〈 比 如 不 同 的 远 端 Git 项 
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目的 路 径 ) 能 实现 针对 配置 文件 的 统一 维护 管理 。 
总 结 一 下 ， 配 置 服务 器 和 客户 端 对 Spring Cloud 项 目 来 说 有 如 下 作用 : 
第 一 ， 能 统一 管理 配置 。 
第 二 ， 提 供 了 访问 远 端 配置 服务 器 的 接口 。 
第 三 ， 能 做 到 和 基于 Spring Cloud 架构 的 微服 务 体系 无 颖 衔接 。 
第 四 ， 能 以 较 小 的 代价 应 对 配置 文件 的 变更 。 


8.3.2 ”在 服务 端 验证 配置 仓库 访问 权限 


在 以 上 案例 中 ， 我 们 配置 的 远 端 Git 和 SVN 服务 器 都 没有 设置 用 户 名 和 密码 。 如 果 Git 仓库 
中 设置 了 访问 用 户 名 和 密码 ， 那 么 我 们 可 以 在 服务 端的 application.yml 中 通过 如 下 方式 来 配置 。 


spring: 
cloud: 
config: 
SerVer: 
git: 

uri: XXX 
username: root 
Passowrd: 123456 


其 中 , 在 第 7 行 和 第 8 行 中 , 我 们 设置 了 访问 Git 服务 器 的 用 户 名 和 密码 ， 请 注意 它们 的 层 纪 
结构 。 
如 果 我 们 连接 的 是 SVN 服务 器 ， 那 么 在 application.yml 中 可 以 通过 如 下 方式 来 配置 。 


oamwmwwnbP 


下 spring: 

2 cloud: 

3 config: 

4 server: 

5 svn: 

6 Uri:xxx 

| username: root 

8 password: 123456 


在 第 7 行 和 第 8 行 中 ， 我 们 通过 username 和 password 两 个 属性 来 配置 用 户 名 和 密码 。 


8.3.3 在 服务 端 配置 身份 验证 信息 


在 8.3.2 小 节 ， 我 们 讲述 了 在 远 端 配置 仓库 配置 用 户 名 和 密码 后 ， 需 要 在 服务 端的 配置 文件 中 
做 对 应 的 设置 。 这 里 ， 我 们 可 以 通过 spring-boot-starter-security 在 服务 端 设 置身 份 验证 信息 ， 这 样 
在 客户 端 连接 服务 端 时 就 得 输入 服务 端 设置 的 用 户 名 和 密码 。 
我 们 将 通过 改写 SVN 配置 中 心 的 案例 来 实现 在 服务 端 配置 身份 验证 信息 的 效果 。 
步 又 014 在 SVNConfigServer 项 目的 pom 文件 中 添加 相关 的 依赖 包 ， 关 键 代 码 如 下 。 
5 <dependency> 


<groupId>org.springframework.boot</groupId> 
3 <artifactId>spring-boot-starter-security</artifactId> 
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4 <version>1.5.6.RELEASE</version> 
5 </dependency> 


步 又 024 在 SVNConfigServer 项 目的 application.yml 中 增加 security 相关 配置 ， 代 码 如 下 。 


1 server: 

2 port: 5566 

| spring: 

4 application: 

5 name: SpringCloudConfigSVNServer 
6 profiles: 

3 active: subversion 

8 cloud: 

9 config: 

10 server: 

3 svn: 

TI2 uri: svn://subversion.coding.net/hsm_computer/ 


PropertiesBySVN/branches 
13 security: 


14 user: 
15 name: root 
16 password: 123456 


其 中 ， 在 第 13~16 行 ， 我 们 添加 了 安全 配置 相关 的 用 户 名 和 密码 信息 。 请 大 家 注意 ， 第 13 行 
的 security 的 配置 和 第 3 行 的 spring 配置 项 是 平 级 的 。 
步骤 034 在 客户 端 SVNConfigClient 项 目的 bootstrap.yml 文件 中 增加 用 户 名 和 密码 的 配置 ， 
关键 代码 如 下 。 
1 spring: 
2 application: 
3 name: svn 
4 cloud: 
5 config: 
6 profile: prod 
3 label: master 
8 uri: http://localhost:5566 
9 username: root 
10 password: 123456 


请 大 家 注意 第 9 行 和 第 10 行 ， 这 里 配置 的 用 户 名 和 密码 需要 和 服务 端的 一 致 。 

至 此 , 代码 完成 。 启动 SVNConfigServer 后 , 输入 “http://localhost:5566/master/svn-prod.properties”， 
第 一 次 访问 的 时 候 ， 会 要 求 我 们 输入 在 服务 端 配置 的 用 户 名 和 密码 。 

再 次 启动 SVNConfigClient， 输 入 “http://localhost:5577/getConfigBySvn”， 则 能 看 到 对 应 的 属 
性 值 。 这 里 请 注意 ， 如 果 去 掉 上 述 SVNConfigClient 项 目 bootstrap.yml 文件 中 的 username 和 
password， 在 客户 端 就 无 法 读 取 到 对 应 配置 值 了 。 


8.3.4 ”访问 配置 仓库 子 目录 中 的 配置 


在 一 个 项 目 中 ， 一 般 会 有 多 个 模块 ， 比 如 某 电 商 项 目 会 分 订单 管理 和 客户 管理 模块 。 出 于 方 
便 管理 的 考虑 ， 在 配置 中 心 的 远 端 仓库 中 ， 我 们 可 以 通过 不 同 的 子 目 录 来 存放 不 同 模块 的 配置 。 
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在 8.2.1 小 节 准 备 的 SVN 环境 中 , 我 们 在 PropertiesBySVN 项 目的 branches/master 目录 中 , 通 
过 TortoiseSVN 添加 两 个 子 目 录 ， 分 别 为 CustomerProj 和 OrderProj， 在 其 中 分 别 添加 
order-prod.properties 和 customer-prod.properties 两 个 配置 文件 。 

其 中 ，order-prod.properties 中 的 内 容 如 下 。 

下 env.name=prod 

本 prod.name=order 

而 customer -prod.properties 中 的 内 容 如 下 。 

下 env.name=prod 

可 prod.name=customer 

随后 ,我 们 需要 在 SVNConfigServer 项 目的 application.yml 中 通过 searchPaths 属性 来 指定 待 访 
问 配置 文件 的 路 径 ， 关 键 代 码 如 下 。 


1 spring: 

2 cloud: 

3 config: 

4 server: 

svn: 

6 uri: svn://subversion.coding.net/hsm computer/ 
PropertiesBySVN/branches 

4 searchPaths: Orderproj,CustomerProj 

请 大 家 注意 第 7 行 的 代码 ， 在 这 里 searchPaths 的 值 是 两 个 子 目 录 ， 它 们 通过 逗号 分 隔 ， 这 样 


配置 中 心服 务 器 和 客户 端 就 会 从 中 查找 配置 。 

下 面 来 验证 一 下 。 启动 SVNConfigServer, 并 输入 “http://localhost:5566/master/customer-prod.properties”， 
能 看 到 具体 的 配置 值 。 请 注意 ， 在 访问 customer-prod.properties 时 ， 我 们 并 没有 在 url 中 输入 
CustomerProj 路 径 ， 但 配置 服务 器 会 根据 searchPaths 的 值 到 两 个 指定 的 路 径 中 去 寻找 ， 并 从 中 找 
到 该 配置 。 同 理 ， 如 果 我 们 输入 “http://localhost:5566/master/order-prod.properties ”， 也 能 看 到 
order-prod.properties 中 的 配置 值 。 

需要 说 明 的 是 ， 我 们 只 需 在 服务 端 配 置 searchPaths， 在 客户 端 无 须 指 定 。 事 实 上 ， 客 户 端 是 
一 个 个 具体 的 功能 模块 ， 在 其 中 只 需 访问 适合 自己 的 配置 文件 即 可 ， 而 无 须 关注 其 他 模块 的 配置 。 

比如 ， 我 们 把 SYNConfigClient 理解 成 订单 管理 模块 ， 在 其 中 只 需 读 取 order-prod.properties 中 的 
配置 , 那么 我 们 只 需要 在 bootstrap.yml 中 把 spring.application.name 修改 成 order, 其 他 配置 项 无 须 变动 。 

随后 ， 把 Controller.java 中 的 getConfig 方法 改写 成 如 下 代码 ， 读 取 prod.name 的 配置 项 。 


ll Public String getConfig() { 
2 return env.getProperty("prod.name"); 
3 } 


启动 服务 器 器 和 客户 端 程序 , 再 输入 “http://localhost:5577/getConfigBySvn”, 即 可 得 到 “order” 
这 个 对 应 的 配置 值 。 


8.3.5 ”在 本 地 备份 远 端 仓库 中 的 配置 


如 果 我 们 把 配置 文件 放 在 远 端的 Git 或 SVN 仓库 ， 那 么 有 必要 在 本 地 存放 一 份 备份 ， 这 样 万 
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一 远 端 服务 器 出 现 故障 ， 那 么 还 可 以 用 本 地 的 配置 来 应 急 。 通 过 basedir 属性 ， 我 们 就 可 以 指定 本 
地 存放 远 端 仓库 文件 的 路 径 。 

比如 在 SYNConfigServer 项 目的 application.yml 中 , 我 们 可 以 按 如 下 第 6 行 的 方式 设置 basedir 
的 属性 值 是 CNsvnDir。 

1 spring: 
cloud: 

config: 
server: 
SVvn: 
basedir: C:\\svnDir 

设置 完成 后 , 启动 服务 器 , 当 我 们 再 次 通过 诸如 http://localhost:5566/master/order-prod.properties 

的 方式 访问 远 端 配 置 时 ， 在 C 盘 下 的 svnDir 中 即 可 看 到 远 端 仓库 中 的 所 有 配置 ， 如 图 8.5 所 示 。 


邮 址 男 ) | 中 C: \svaDir \nester 


acwN 


文件 和 文件 夹 任务 和 | 一 | | OrderProj 
加 了 一 个 新 文件 天 


图 8.5 在 本 地 保存 远 端 仓库 配置 文件 的 效果 图 


如 果 我 们 用 的 是 Git 远 端 仓库 ， 那 么 可 以 在 spring.cloud.config.server.git.basedir 配置 中 指定 本 
地 路 径 的 位 置 ， 效 果 是 一 样 的 。 


8.3.6 ”用 本 地 属性 覆盖 远 端 属性 


在 发 布 项 目 或 在 修复 生产 环境 的 问题 时 ， 有 时 我 们 需要 紧急 更 改 配置 ， 此 时 如 果 来 不 及 更 改 
远 端 仓库 中 的 配置 《比如 权限 不 够 ) ， 就 需要 在 本 地 修改 配置 后 ， 用 它 覆 盖 掉 远 端的 值 。 我 们 固然 
可 以 通过 设置 禁止 本 地 覆盖 远 端 的 配置 ， 但 不 建议 这 样 做 。 

我 们 来 演示 一 下 覆盖 远程 属性 的 做 法 。 当 前 在 SVN 服务 器 上 的 order-prod.properties 文件 中 ， 
prod.name 的 属性 是 order。 在 SVNConfigServer 项 目的 application.yml 中 ， 我 们 可 以 通过 如 下 方式 
来 重 定义 该 属性 。 


1 spring: 

2 cloud: 

3 config: 

4 server: 

5 overrides: 
6 prod: 

yl 


name: myOrder 


也 就 是 说 ， 我 们 可 以 通过 spring.cloud.config.server.overrides 属性 来 实现 覆盖 的 效果 ， 由 于 这 
里 我 们 需要 覆盖 prodname 的 值 ， 因 此 可 以 通过 上 述 第 6 行 和 第 7 行 的 代码 来 实现 。 

完成 修改 后 ， 再 次 启动 SVNConfigServer 项 目 ， 即 可 看 到 prod.name 的 值 是 myOrder， 而 不 是 
过 程 SVN 服务 器 上 定义 的 order。 

另外 ， 当 我 们 访问 http://localhost:5566/master/svn-prod.properties 时 ， 虽 然 在 SVN 上 ， 这 个 配 
置 文件 中 并 没有 包含 prod.name 属性 ， 但 还 是 能 看 到 该 属性 的 值 是 myOrder， 如 图 8.6 所 示 。 
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prod. maxCormection: 200 
Prod.name: myOrder 


图 8.6 覆盖 属性 的 效果 图 


此 时 ， 我 们 可 以 在 svn-prod.properties 文件 中 加 入 “prod.name=svn” 这 个 配置 ， 再 次 启动 服务 
器 , 并 输入 “http://localhost:5566/master/svn-prod.properties”, 我 们 还 是 能 看 到 “prod.name: myOrder” 
的 输出 。 

这 说 明 , 我 们 通过 spring.cloud.config.server.overrides 覆盖 了 所 有 配置 文件 中 的 prod.name 属性 ， 
也 就 是 说 这 种 覆盖 是 全 局 性 的 。 

综 上 所 述 ， 针 对 用 本 地 属性 覆盖 远 端 的 做 法 ， 我 们 需要 注意 如 下 两 点 。 

第 一 ， 应 当 避 免 其 他 配置 文件 中 同名 属性 值 也 被 误 覆 盖 ， 因 为 我 们 看 到 这 种 覆盖 是 全 局 性 的 。 

第 二 ， 从 项 目 运行 维护 的 角度 来 看 ， 远 端 服务 器 上 的 配置 文件 应 当 和 配置 中 心 的 一 致 ， 所 以 
建议 大 家 修改 本 地 配置 后 ， 应 当 及 时 更 新 到 远 端 服务 器 上 。 


8.3.7 _ failFast 属性 


当 配 置 中 心 客户 端 〈 功 能 模块 ) 在 启动 时 ， 如 果 发 现 无 法 从 配置 服务 器 上 获得 相关 配置 参数 
(比如 配置 服务 器 因 网 络 原因 不 可 用 〉 ,那么 可 以 在 启动 脚本 中 给 相关 参数 设置 默认 值 ， 同 时 启动 
客户 端 。 
但 在 有 些 场景 中 , 应 当 终止 启动 客户 端 。 对 此 , 我 们 设置 spring.cloud.config.failFast 属性 为 tue 
即 可 。 我 们 来 验证 一 下 这 个 参数 的 效果 。 

步 又 014 在 不 启动 SVNConfigServer 的 前 提 下 ， 不 在 SVNConfigClient 项 目的 bootstrap.yml 
中 加 入 spring.cloud.config.failFast 属性 ， 此 时 启动 SVNConfigClient， 虽 然 无 法 连接 到 配置 服务 器 ， 
但 至 少 启动 不 会 报错 。 

步骤 02 和 在 SVNConfigClient 项 目的 bootstrap.yml 中 加 入 failFast 属性 ， 关 键 代 码 如 下 。 


1 ‘spring* 

2 cloud: 

3 config: 
4 failFast: true 


还 是 在 SVNConfigServer 不 可 用 的 前 提 下 启动 SVNConfigClient， 此 时 启动 会 失败 。 


8.3.8 与 failFast 配套 的 重 试 相关 参数 


在 failFast 等 于 true 的 前 提 下 ,根据 异常 处 理 的 原则 ， 一 旦 发 现 配置 服务 器 不 可 用 ， 我们 可 以 
做 几 次 重 试 操作 ,在 多 次 重 试 后 发 现 服 务 器 确实 不 可 用 时 才 终 止 客户 端的 启动 动作 。 对 此 ,我 们 可 
以 通过 如 下 步 又 实现 “失败 重 试 ” 的 效果 。 具 体 的 实现 步骤 如 下 。 
步骤 014 在 SVNConfigClient ( 配置 客户 端 ) 的 pom.xml 中 加 入 和 重 试 相关 的 依赖 项 ， 关 键 
代码 如 下 。 


052 省 


PoomIAAwGDp 


0 
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<dependency> 

<groupId>org.springframework.retry</groupId> 
<artifactId>spring-retry</artifactId> 
<version>1.2.2.RELEASE</version> 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-aop</artifactId> 
<version>1.5.7.RELEASE</version> 

</dependency> 


步骤 02A 在 bootstrap.yml 中 添加 和 重 试 相关 的 参数 ， 关 键 代 码 如 下 。 


加 
3 
4 
5 
6 
7 
8 


spring: 
cloud: 
config: 
retry: 
initial-interval: 10 
max-interval: 100 
max-attempts: 3 
multiplier: 2 


其 中 , 第 5~8 行 的 参数 都 是 和 重 试 有 关 的 , 它们 都 有 spring.cloud.config.retry 的 前 级 。 在 表 8.1 
中 ， 我 们 归纳 了 这 些 参 数 的 含义 。 


表 8.1 和 重 试 相关 的 参数 的 含义 


参数 名 含义 
第 一 次 重 试 的 时 间 间 隔 ， 单 位 是 毫秒 ， 上 默认 是 1000 毫秒 
最 大 的 重 试 时 间 间 隔 ， 单 位 是 毫秒 ， 默认 是 2000 毫秒 
| 最 大 的 重 试 次 数 , 默 证 6 


最 大 的 重 试 次 数 ， 默 认 是 6 


|_ muttiptier 。 ”| 和 上 次 重 试 时 间 间 隔 相 比 ， 本 次 重 试 时 间 间 隔 的 递增 系数 
前 面 我 们 配置 的 重 试 次 数 是 3， 第 一 次 重 试 的 时 间 间 隔 是 10 毫秒 ， 也 就 是 说 ,第 一 次 失败 后 ， 


下 次 重 试 的 时 间 间 隔 是 10 毫秒 。 我 们 设置 的 multiplier 是 2， 即 第 二 次 重 试 的 时 间 间 隔 是 第 一 次 重 


试 的 2 倍 ， 即 20 毫秒 。 也 就 是 说 ， 每 次 重 试 的 时 间 间 隔 有 递 进 的 关系 ， 但 最 大 的 时 间 间 隔 是 
max-interval (这 里 是 100) 。 

设置 完成 后 ， 再 次 启动 SVNConfigClient 依然 会 失败 ， 但 在 失败 前 ， 在 控制 台中 能 看 到 如 图 
8.7 所 示 的 效果 。 从 中 我 们 能 看 到 ， 在 失败 前 确实 重 试 了 3 次 ， 这 和 之 前 设置 的 max-attempts 参数 
是 一 致 的 。 


Fetching config from server at: :5566 
Fetc g config from server at: h :5566 
Fetching config from server at: h :5566 


Application startup failed 


图 8.7 失败 前 重 试 的 效果 图 


在 实际 项 目 中 ， 只 有 在 偶发 性 的 网 络 异常 场景 中 ， 重 试 机 制 才能 保证 配置 客户 端 最 终 能 连 上 


服务 器 ， 如 果 配 置 服务 器 确实 失效 了 ， 那 么 再 怎么 重 试 也 没有 帮助 。 所 以 说 ， 针 对 上 述 寻 


E 试 参数 ， 
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如 果 没 有 特殊 的 情况 ， 可 以 采用 如 下 配置 建议 。 


第 一 ， 重 试 次 数 不 宜 过 多 ， 别 超过 默认 指定 的 6 次 。 
第 二 ， 最 大 的 重 试 间隔 不 宜 过 长 ， 别 到 最 后 得 间隔 1 分 钟 才 能 重 试 。 
第 三 ，multiplier 参数 尽量 采用 递增 的 配置 方式 。 


总 之 ， 大 家 可 以 根据 项 目 实际 情况 配置 上 述 参 数 ， 但 如 果 没 有 特殊 情况 ， 尽 量 采 用 默认 值 。 
8.4 _ Spring Cloud Config 与 Eureka 的 整合 


在 实际 项 目 中 ， 配 置 中 心 组 建 Spring Cloud Config 一 般 会 和 服务 发 现 和 治理 框架 Eureka 整合 
使 用 ， 往 往 会 配置 一 个 由 Spring Cloud Config Server 构成 的 配置 服务 器 、 一 个 (或 多 个 ) Eureka 服 
务 器 和 多 个 提供 服务 的 微服 务 模块 。 

其 中 , 提供 服务 的 微服 务 模块 不 仅 会 向 Eureka 服务 器 注册 , 因为 它们 本 身 就 是 Eureka 客户 端 ， 
而 且 会 向 配置 中 心 的 服务 器 请 求 配置 参数 ， 所 以 也 是 配置 中 心 的 客户 端 。 


8.4.1 本 案例 的 体系 结构 和 项 目 说 明 


代码 \ 第 8 章 \EurekaConfigServer 
\ 第 8 章 \SpringCloudConfig 与 Eureka 的 整合 
代码 \ 第 8 章 \EurekaConfigClient 视频 第 8 章 \SpringCloudConfig 与 Bureka 的 整合 


在 实践 中 ， 我 们 可 以 把 配置 中 心服 务 器 和 Eureka 服务 器 放 在 不 同 的 项 目 中 ， 出 于 高 可 用 性 的 
考虑 ， 甚 至 可 以 把 它们 部 署 在 不 同 的 服务 器 上 。 如 果 项 目 规模 不 大 ， 我 们 可 以 把 两 者 合 二 为 一 ， 让 
同一 个 Spring Cloud 项 目 同时 承担 配置 服务 器 和 Eureka 服务 器 的 角色 ， 本 项 目 就 将 演示 这 样 的 效 


果 。 

此 外 ， 本 案例 中 的 服务 提供 者 将 通过 Spring Data 连接 MySQL， 从 中 得 到 数据 后 再 返回 。 在 实 
际 项 目 中 ， 还 应 当 包 含 Ribbon、Hystrix、Feign 以 及 Zuul 等 的 组 件 ， 这 里 我 们 为 了 不 喧 宾 夺 主 ， 
就 只 演示 Spring Cloud Config 与 Eureka 的 整合 方式 。 本 案例 的 体系 结构 如 图 8.8 所 示 。 


Ns 配置 服务 器 和 
有 
Cit 仓 库 | 
读 取 配置 
注册 服务 
通过 JPA 


读数 据 [配置 客户 端 , 
be 也 是 Eureka 容 户 端 


图 8.8 Spring Cloud Config 整合 Eureka 的 效果 图 
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8.4.2 ”准备 数据 库 环 境 和 Git 配置 信息 


我 们 将 用 到 第 2 章 创建 的 MySQL 环境 ， 当 时 我 们 在 MySQL 中 一 个 名 为 springboot 的 数据 库 
中 创建 了 一 个 名 为 student 的 表 ， 结 构 如 表 8.2 所 示 。 


表 8.2 student 表 结 构 的 说 明 


| 字段 名 类 型 全 多 

id Varchar 主键 ,学 号 

| name Varchar 姓名 | 
| age Varchar 年 龄 | 
| score float 成 绩 | 


该 表 中 有 如 图 8.9 所 示 的 一 条 数据 。 


age name score 


id 
| 画 : Tom 100 
8.9 _ student 表 中 的 一 条 数据 
我 们 将 用 到 8.1 节 所 描述 的 Git 仓库 ， 有 具体 而 言 ， 是 在 https://coding.net 网 站 的 
springcloudGitProject 项 目 中 存在 一 个 master 分 支 ， 在 其 中 的 git-prod.properties 配置 文件 中 输入 如 
下 关于 MySQL 连接 的 配置 信息 。 


1 prod.url = jdbc:mysql://localhost:3306/springboot 
2 prod.username = root 
3 prod.password 123456 


至 此 ， 数 据 库 环境 和 Git 仓库 准备 完毕 。 


8.4.3 配置 服务 器 与 Eureka 服务 器 合 二 为 一 


EurekaConfigServer 项 目 承担 着 Spring Cloud Config 配置 服务 器 和 Eureka 服务 器 的 双重 职责 ， 
该 项 目的 关键 开发 步 又 如 下 。 


步 又 014 在 该 项 目的 pom.xml 中 引入 Spring Cloud Config Server 和 Eureka 服务 器 的 依赖 包 ， 
关键 代码 如 下 。 


1 <dependencies> 

2 <dependency> 

3 <groupId>org.springframework.cloud</groupId> 
4 <artifactId>spring-cloud-starter-eureka-server</artifactId> 
5 </dependency> 

6 <dependency> 

7 <groupId>org.springframework</groupId> 

8 <artifactId>spring-core</artifactId> 

9 <version>4.3.8.RELEASE</version> 

10 </dependency> 

4 <dependency> 

12 <groupId>org.springframework.cloud</groupId> 
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13 
14 


<artifactId>spring-cloud-config-server</artifactId> 
</dependency> 


15 </dependencies> 


其 中 ， 我 们 通过 第 2~10 行 代码 引入 了 Eureka 服务 器 的 依赖 包 ， 通 过 第 11~14 行 代码 引入 了 
Spring Cloud Config 服务 器 的 依赖 包 。 


步骤 024 在 application.yml 中 引入 配置 中 心 和 Eureka 服务 器 的 相关 配置 参数 ， 代 码 如 下 。 


ownamwmwwnP 


FFPR PR PP 
ooamwwNP 


9 


server: 
port: 8888 
eureka: 
instance: 
hostname: localhost 
client: 
register-with-eureka: false 
fetch-registry: false 
serviceUrl: 
defaultZone: http://localhost:8888/eureka/ 
spring: 
application: 
name: EurekaConfigServer 
cloud: 
config: 
server: 
git: 
uri: https://git.coding.net/hsm computer/ 
springcloudGitProject.git 
clone-on-start: true 


其 中 , 我 们 通过 第 1~10 行 代码 指定 了 Eureka 服务 器 的 配置 信息 , 这 里 和 之 前 我 们 用 到 的 相关 
配置 非常 相似 ， 而 在 第 11~19 行 代码 中 指定 了 Git 仓库 的 相关 配置 ， 这 些 Git 配置 信息 的 取 值 方式 
如 8.1.3 小 节 的 描述 ， 而 且 它 们 是 和 Git 仓库 中 的 项 目 名 、 文 件 名 和 版 本 名 能 完全 匹配 上 的 。 

步骤 034 在 EurekaConfigServer 类 中 编写 启动 类 的 代码 。 


iomo~wamwm 必 wm 


这 里 main 函数 的 代码 非常 中 规 中 和 矩 , 但 由 于 该 项 目 承担 着 Eureka 服务 器 和 配置 服务 器 的 双 和 


// 省 略 必 要 的 package 和 import 代码 

@EnableConfigServer 

@EnableEurekaServer 

@SpringBootApplication 

public class EurekaConfigServer { 
public static void main( String[] args ){ 
SpringApplication.run (EurekaConfigServer.class, args); 
} 

} 


ey 


角色 ， 因 此 需要 在 第 2~4 行 中 加 入 相关 的 注解 。 
至 此 ， 服 务 器 部 分 的 代码 开发 完成 。 我 们 可 以 用 如 下 方式 来 验证 : 启动 EurekaConfigServer 
类 ， 并 在 浏览 器 中 输入 “http://localhost:8888/master/git-prod.yml”， 则 能 看 到 如 下 配置 信息 。 


1 
2 
3 


prod: 
password: '123456"' 
url: jdbc:mysql://localhost:3306/springboot 
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4 username: root 


8.4.4 配置 客户 端 与 Eureka 客户 端 合 二 为 一 


这 里 我 们 同样 让 EurekaConfigClient 项 目 承 担 如 下 两 种 角色 。 


第 一 ， 它 是 配置 客户 端 ， 所 以 在 该 项 目 中 可 以 通过 配置 服务 器 读 取 Git 仓库 中 的 配置 。 
第 二 ， 它 是 Eureka 客户 端 ， 该 项 目 中 提供 的 服务 需要 向 Eureka 服务 器 注册 ， 注 册 后 ，Eureka 
服务 器 即 可 监控 和 管理 该 服务 。 
此 外 ， 该 项 目 还 通过 第 2 章 提 到 的 JPA 组 件 来 连接 并 读 取 MySQL 数据 库 ， 该 项 目的 关键 实 
现 步 骤 如 下 。 
步骤 01 在 pom.xml 文件 中 引入 Eureka 客户 端 、Spring Cloud Config 配置 客户 端 、JPA 组 件 
以 及 MySQL 的 相关 依赖 包 ， 关键 代 码 如 下 。 


1 <dependencies> 

2 <dependency> 

3 <groupId>org.springframework.boot</groupId> 

4 <artifactId>spring-boot-starter-web</artifactId> 
5 <version>1.5.4.RELEASE</version> 

6 </dependency> 

7 <dependency> 

8 <groupId>org.springframework.cloud</groupId> 

9 <artifactId>spring-cloud-starter-eureka</artifactId> 
10 </dependency> 

3 <dependency> 

12 <groupId>org.springframework.cloud</groupId> 

3 <artifactId>spring-cloud-starter-config</artifactId> 
14 </dependency> 

rE <dependency> 

16 <groupId>org.springframework.boot</groupId> 

bs <artifactId>spring-boot-starter-data-jpa</artifactId> 
18 <version>1.5.4.RELEASE</version> 

19 </dependency> 

20 <dependency> 

2 <groupId>mysql</groupId> 

受 邓 <artifactId>mysql-connector-java</artifactId> 

23 <version>5.1.3</version> 

24 </dependency> 


25 </dependencies> 


步骤 02h 在 bootstrap.yml 中 引入 Eureka 客户 端 和 配置 客户 端的 相关 代码 。 前 面 我 们 已 经 
析 过 为 什么 把 这 些 配 置信 息 放 入 bootstrap.yml 而 不 是 application.yml 的 原因 , 所 以 这 里 就 不 再 重复 
国富 


server: 
port: 8899 
spring: 
application: 
name: git 
cloud: 


mon 必 wN 
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了 config: 

8 Profile: Prod 

9 label: master 

10 uri: http://localhost:8888 
11 management: 

12 security: 

3 enabled: false 


14 eureka: 

5 client: 

16 serviceUrl: 

17 defaultZone: http://localhost:8888/eureka/ 

其 中 ,在 第 3~13 行 指 定 了 客户 端的 配置 ， 根 据 这 些 参 数 ， 我 们 能 通过 配置 服务 器 成 功 地 读 取 
到 Git 仓库 上 的 配置 信息 ; 在 第 14~17 行 代码 中 ， 我 们 指定 了 该 客户 端 是 向 
http://localhost:8888/eureka/ 这 个 Eureka 服务 器 注册 的 。 

步 最 034 在 application.properties 中 引入 JPA 相关 的 配置 。 这 里 需要 说 明 的 是 ， 我 们 完全 可 

以 把 这 部 分 的 内 容 合 并 到 bootstrap.yml 中 ， 这 里 是 为 了 更 直观 地 演示 连接 JPA 的 配置 参数 ， 所 以 
才 分 开 编 写 的 。 
spring.jpa.show-sql = true 


spring.jpa.hibernate.ddl-auto=update 
spring.datasource.driver-class-name=com.mysql.jdbc.Driver 


spring.datasource.url=${prod.url} 
spring.datasource.username=$ {prod.username} 
spring.datasource.password=$ {prod.password} 

关键 是 第 5~7 行 代码 ， 请 大 家 注意 两 点 : 第 一 ， 我 们 是 用 ${ 配 置 值 } 的 方式 动态 地 指定 连接 参 
数 的 ， 第 二 ， 我 们 指定 的 诸如 prod.url 等 参数 ， 需 要 和 Git 仓库 中 的 配置 参数 一 致 。 事 实 上 ， 我 们 
已 经 在 Git 仓库 的 git-prod.properties 文件 中 指定 了 prod.url、prod.username 和 prod.password 的 值 ， 
所 以 这 里 才能 得 到 正确 的 MySQL 连接 信息 。 
步骤 044 编写 JPA 相关 的 Model 类 、Service 类 和 Repository 类 的 相关 代码 。 这 部 分 代码 虽 
然 重要 , 但 和 本 部 分 配置 中 心 和 Eureka 整合 的 主题 无 关 ， 而 且 在 第 2 章 中 已 经 给 出 了 详细 的 描述 ， 
所 以 这 里 就 不 再 给 出 代码 了 ， 大 家 可 以 参照 本 小 节 给 出 的 代码 和 相关 视频 内 容 。 
步骤 054 编写 对 外 提供 服务 的 控制 器 类 Controllerjava， 代 码 如 下 。 


aowmwwmn 


1 // 省 略 必要 的 package 和 import 的 代码 

2  @RestController 

3 public class Controller { 

4 eautowired // 引 入 student Service 类 

5 Private StudentService studentService; 

6 @RequestMapping (value = "/find/name/ {name}") 

a Public List<Student> getStudentByName (@PathVariable String name) { 
8 List<Student> students = studentService.findByName (name); 
和 return students; 

10 } 

TS 


在 第 5 行 中 ， 我 们 通过 @Autowired 注解 引入 了 student Service 类 ， 在 第 7~10 行 的 
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getStudentByName 方法 的 第 8 行 中 ， 我 们 通过 该 student Service 类 的 findByName 方法 ， 根 据 参数 
传 入 的 name,， 到 Student 数据 表 中 获取 对 应 的 数据 并 返回 。 这 部 分 获取 数据 的 功能 我 们 是 通过 JPA 
组 件 来 实现 的 。 

而 且 , 通过 第 6 行 的 @RequestMapping 注解 , 我 们 能 够 看 到 , 一 旦 我 们 调用 了 /find/name/fname} 
格式 的 url，getStudentByName 方法 就 会 被 触发 。 


步 最 064 编写 启动 类 ConfigClientAppjava, 这 个 类 和 其 他 Eureka 客户 端的 启动 类 非常 相似 ， 
代码 如 下 。 


// 省 略 必 要 的 package 和 import 代码 

@EnableEurekaClient 

@SpringBootApplication 

public class ConfigClientApp { 
public static void main( String[] args ){ 
SpringApplication.run(ConfigClientApp.class, args); 
上 


oauwmewm 


8.4.5 查看 运行 效果 


完成 上 述 服 务 器 端 和 客户 端的 代码 后 ， 依 次 启动 EurekaConfigServer 和 EurekaConfigClient， 
随后 ， 当 我 们 在 浏览 器 中 输入 “http://localhost:8899/find/name/tom” 时 ， 就 能 看 到 有 如 下 输出 。 


name"s "Ton" "age "liO" nscore™s L000 "Ld Li 


这 说 明 ， 在 客户 端的 代码 中 ，Spring 容器 成 功 地 读 到 了 Git 配置 ， 所 以 类 似 $ {prod.url} 格 式 的 
变量 被 赋予 了 正确 的 值 , 在 此 基础 上 , 服务 提供 者 ( 即 getStudentByName 方法 ) 通 过 JPA 从 MySQL 
数据 库 中 得 到 了 所 需 数据 并 返回 。 

这 里 请 注意 ， 我 们 也 可 以 如 8.2.3 小 节 那 样 ， 在 Java 代码 中 ， 通 过 env.getProperty(" 属 性 名 ") 
的 方式 得 到 Git 配置 并 处 理 。 

但 在 JPA 或 其 他 设置 datasource) 的 场景 中 ， 我 们 往往 需要 在 配置 文件 中 设置 和 连接 相关 的 
参数 。 在 这 类 场景 中 ， 大 家 可 以 在 配置 文件 中 采用 本 小 节 给 出 的 “${ 属 性 名 } ”方式 直接 给 相关 属 
性 赋值 。 


8.5 本 章 小 结 


本 章 主 要 讲述 了 Spring Cloud Config 组 件 以 Git 和 SVN 两 种 方式 管理 分 布 式 项 目 中 配置 文件 
的 做 法 , 具体 包括 如 何 搭建 配置 仓库 、 如 何在 项 目 中 使 用 配置 仓库 中 的 配置 信息 以 及 如 何以 安全 的 
方式 访问 配置 文件 。 

此 外 ， 本 章 还 给 出 了 Spring Cloud Config 和 Eureka 组 件 整合 使 用 的 方式 ， 大 家 在 读 完 本 章 后 ， 
可 以 全 面 了 解 Spring Cloud Config 的 常见 用 法 。 
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消息 机 制 与 消息 驱动 框 染 


当 业 务 模块 中 类 之 间 的 关联 关系 过 于 复杂 ， 以 至 于 成 为 项 目 扩展 和 维护 的 痛 点 时 ， 我 们 就 有 
必要 把 它 拆 分 成 若干 个 微服 务 模块 ， 这 些微 服务 模块 间 往 往 通过 发 送 消息 来 协同 工作 。 对 此 ， 在 
Spring Cloud 组 件 库 中 ， 我 们 可 以 通过 Spring Cloud Bus (消息 总 线 ) 来 协调 多 个 微服 务 模块 。 

进一步 ， 通 过 Spring Cloud Stream 组 件 〈 消 息 驱 动 框架 ) ， 我 们 无 须 编 写 复杂 的 通信 相关 的 
代码 就 可 以 搭建 基于 “消费 者 组 ”或 “消息 分 区 ”的 消息 收发 框架 。 

总 之 ， 通 过 消息 总 线 或 消息 驱动 框架 组 件 ， 程 序 员 不 仅 可 以 优化 微服 务 模 块 间 的 通信 体系 结 
构 ， 并 且 更 加 关注 消息 的 内 容 ， 而 不 是 和 有 具体 业务 无 关 的 通信 底层 细节 。 


9.1 在 微服 务 中 实现 模块 间 的 通信 


我 们 固然 可 以 自己 编写 代码 ， 利 用 现 有 的 消息 中 间 件 〈 比 如 RabbitMQ 或 Kafka 等 ) 让 各 模块 
相互 发 送 消息 。 但 在 Spring Cloud 微服 务 体系 结构 中 , 我 们 可 以 通过 引入 消息 框架 组 件 来 解 耦合 消 
息 发 送 底层 实现 功能 和 消息 发 生 本 身 的 业务 ， 而 消息 总 线 则 是 消息 框架 组 件 的 重要 构成 。 

在 本 章 的 开篇 ， 我 们 将 为 大 家 理 清 诸多 和 发 送 消息 相关 的 概念 。 


9.1.1 消息 代理 和 消息 中 间 件 


如 果 我 们 要 把 物品 从 上 海 寄 送 到 北京 ， 那 么 我 们 无 须 亲 自 到 北京 一 趟 ， 而 是 可 以 把 东西 交 给 
快递 公司 ， 由 快递 公司 负责 送 到 目的 地 。 在 这 个 例子 中 ,我 们 可 以 把 待 寄 送 的 物品 理解 成 消息 , 把 
快递 公司 理解 成 消息 代理 。 

从 中 我 们 能 看 到 ， 消 息 代理 (Message Broker) 不 仅 具 有 平台 无 关 特 性 不同 的 业务 模块 都 可 
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以 使 用 相同 的 消息 代理 ) ， 而 且 还 能 解 耦合 通信 业务 和 通信 的 底层 实现 细节 。 

实现 消息 代理 的 产品 叫 消 息 中 间 件 ， 常 见 的 消息 中 间 件 有 两 种 : 第 一 种 是 基于 高 级 消息 队列 
协议 (AMQP) 的 RabbitMQ， 它 是 用 Erlang 语言 开发 而 成 的 ， 第 二 种 是 由 Apache 软件 基金 会 开 
发 的 Kafka， 它 是 用 Java 和 Scala 开发 而 成 的 。 


9.1.2 Spring Cloud 体系 中 的 消息 总 线 


在 Spring Cloud 体系 中 ， 如 果 我 们 让 各 模块 间 直 接 相互 发 送 消 息 ,那么 多 个 版 本 和 欠 代 之 后 ,各 
模块 之 间 的 信道 就 可 能 像 蜂 蛛网 那样 复杂 。 一 旦 出 现 业务 扩展 或 功能 维护 , 修改 此 类 复杂 信道 的 代 
价 会 相当 大 ， 这 样 系统 的 维护 成 本 就 非常 高 。 

对 此 ，Spring Cloud 组 件 中 引入 了 消息 总 线 的 概念 : 各 模块 是 通过 消息 总 线 向 消息 代理 (也 可 
以 叫 消息 中 间 件 ) 发 送 消息 的 ， 而 消息 传递 的 底层 实现 细节 〈 比 如 如 何 通过 路 由 再 到 目的 模块 ) 以 
及 失效 重 发 机 制 等 ,程序 员 不 用 关心 。 从 上 述 描述 中 我 们 能 看 到 ， 消 息 总 线 和 消息 中 间 件 是 一 个 有 
机 的 整体 ，Spring Cloud 中 引入 消息 总 线 后 的 结构 如 图 9.1 所 示 。 


微服 务 模块 微服 务 模块 


消息 总 线 〈 含 消息 中 间 件 》 


微服 务 模块 微服 务 模块 


9.1 Spring Cloud 体系 中 消息 总 线 的 效果 示意 图 


从 图 9.1 中 我 们 能 看 到 ， 在 Spring Cloud 微服 务 体系 中 ， 消 息 总 线 就 好 比 是 “快递 公司 ”,， 会 
提供 一 个 统一 的 接口 供 各 模块 发 送 消 息 。 收 到 消息 后 , 会 根据 定义 在 消息 中 间 件 中 的 路 由 规则 把 消 
息 发 送 到 目标 模块 。 


9.1.3 Spring Cloud Stream: 消息 驱动 框架 


消息 总 线 最 大 的 便利 是 能 屏蔽 消息 传递 的 细节 ， 而 且 能 为 消息 的 传递 提供 一 个 统一 的 信道 。 
在 此 基础 上 ， 消 息 驱 动 框架 向 我 们 进一步 封装 了 消息 中 间 件 的 动作 细节 ， 通 过 它 ， 我 们 甚至 只 需 一 
些 简单 的 配置 就 能 定义 模块 间 消 息 传递 的 模式 。 

具体 而 言 ， 在 消息 驱动 框架 中 ， 有 如 下 4 个 比较 重要 的 概念 〈 或 组 件 ) ， 通 过 它们 ， 程 序 员 
甚至 无 须 了 解 消息 中 间 件 的 细节 ， 就 能 在 微服 务 模块 间 传 递 消息 。 

第 一 ， 绑 定 器 。 微 服务 模块 可 以 通过 绑 定 器 与 消息 中 间 件 (比如 RabbitMQ》 相 关联 ， 如 果 更 
换 消息 中 间 件 (比如 换 到 了 Kafka) ， 我 们 只 需要 更 换 相应 的 绑 定 器 代码 ， 而 无 须 变更 消息 发 送 的 
相关 代码 。 这 就 好 比 我 们 通过 JDBC 连接 数据 库 ， 一 旦 数据 库 种 类 发 生变 更 ， 我 们 只 需 更 换 连 接 驱 
动 和 对 应 的 数据 库 配置 信息 。 

第 二 ， 发 布 订 阅 模式 。 在 该 模式 中 ， 程 序 员 能 事先 定义 好 消息 的 发 送 方 和 接收 方 〈《 即 
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destination) ， 一 旦 有 消息 被 发 送 到 消息 中 间 件 ， 所 有 订阅 该 消息 的 模块 都 会 收 到 这 条 消息 。 

第 三 ， 消 费 组 。 在 微服 务 体系 中 ， 出 于 负载 均衡 和 高 可 用 性 的 考虑 ， 我 们 一 般 会 把 同一 套 服 
务 部 署 到 多 个 服务 器 节点 上 ， 在 之 前 的 案例 中 ， 我 们 确实 也 这 样 干 过 。 

也 就 是 说 ， 一 条 消息 可 能 需要 发 到 同一 组 相同 的 消费 节点 上 ， 但 我 们 只 希望 该 组 内 只 有 一 个 
节点 处 理 该 消息 。 对 此 ， 我 们 可 以 利用 消息 驱动 框架 中 “消息 组 ”的 特性 把 这 些 功 能 相同 的 模块 设 
置 成 同一 个 “消息 组 ”， 从 而 保证 该 组 内 只 有 一 个 模块 处 理 消息 。 

第 四 ， 消 费 分 区 。 当 我 们 把 消息 发 送 到 一 个 消息 组 中 时 ， 我 们 无 法 确保 该 消息 会 被 哪个 模块 
处 理 。 比 如 有 三 个 具有 相同 功能 的 模块 构成 了 一 个 负载 均衡 组 件 , 到 达 的 消息 会 根据 当前 负载 情况 
被 其 中 任意 一 个 模块 处 理 ， 但 无 法 保证 每 次 都 被 相同 的 模块 处 理 。 

但 在 一 些 场景 中 ， 我 们 需要 让 具有 某 个 特征 的 消息 被 相同 的 模块 处 理 ， 这 时 就 可 以 用 到 消息 
分 区 的 概念 。 对 于 特定 的 消息 分 区 , 我 们 能 通过 配置 保证 具有 相同 特征 的 消息 在 每 次 到 达 时 都 被 同 
一 个 模块 处 理 。 

这 里 请 大 家 先 理解 上 述 概念 ， 下 文 在 学 习 案例 时 ， 大 家 会 再 次 感受 到 这 些 概 念 在 消息 收发 方 
面 带 给 我 们 的 便利 性 。 


9.2 ”消息 中 间 件 的 案例 


我 们 将 先 讲解 RabbitMQ 和 Kafka 两 大 消息 中 间 件 的 安装 步骤 , 并 在 此 基础 上 给 出 通过 它们 发 
送 和 接收 消息 的 基本 案例 。 本 节 是 后 文 讲述 Spring Cloud Bus 和 Spring Cloud Stream 的 基础 。 


9.2.1 RabbitMQ 的 安装 步骤 


RabbitMQ 是 一 个 基于 AMQP 的 可 复 用 的 企业 消息 中 间 件 系统 。 由 于 RabbitMQ 是 基于 Erlang 

的 ， 因 此 得 先 安装 Erlang， 再 安装 RabbitMQ， 具 体 的 步骤 如 下 。 

步骤 014 到 http:/www.erlang.org/ 官 网 上 下 载 Erlang 的 安装 包 。 这 里 请 注意 ， 需 要 根据 自己 
的 操作 系统 下 载 32 位 或 64 位 的 安装 包 。 

步骤 024 安装 完 Erlang 后 ， 在 环境 变量 中 新 增 一 个 变量 ERLANG_HOME, 该 变量 需要 指向 
Erlang 的 安装 路 径 。 

步骤 034 到 http://www.rabbitmq.com/download.html 页 面 下 载 RabbitMQ 的 安装 包 , 这 里 请 同 
样 注意 32 位 和 64 位 的 差别 ， 而 且 安装 的 版 本 需要 和 之 前 Erlang 的 版 本 兼容 。 一 般 来 说 ， 安 装 之 
后 ，RabbitMQ 的 服务 会 自动 启动 。 

步骤 044 在 命令 窗口 执行 rabbitmq-plugins enable rabbitmq_management, 开启 窗口 管理 模式 。 


随后 ， 在 浏览 器 中 输入 “http://localhost:15672/”， 能 看 到 一 个 登录 页 面 ， 用 户 名 和 密码 默认 
都 是 guest， 如 图 9.2 所 示 。 这 里 如 果 有 问题 ， 请 通过 第 4 步 开 启 窗 口 管 理 模 式 。 


162 | Spring Cloud 实战 


er UE 
: rabbt@Xp-201512240PQT (dhanae 
RabbitMQ 3.6.10.908, Erang 18.0 


abblt 


[cmecio chamels Exchanoes Oveves Admin 


Overview 


r Totals 


Queued messages (chart: Inst 
Currently idle 

Message rates (chart last minute) (? 
Currently idle 


Global counts 


Connecions: 0 Channels: 0 Exchanges: 8 Queues: 0 Consumers: 0 


Node 


Node: rabbit@xp-201512240PQT (More about this node) 


File descriptors (3) Socket deaoripters Eriang processes Memory Disk space Rates Info | Reset sta 
mode De 
o 0 323 33Ma 1768 basc Gi kee] 


8192 avaiable 7280 avalable ”1048576 avaibble 819MB hgh watarmaieMB low watermark 


9.2 ”RabbitMQ 管理 页 面 的 效果 图 


9.2.2 ”通过 RabbitMQ 发 送 和 接收 消息 的 案例 


这 里 ， 我 们 新 建 一 个 名 为 RabbitMQSimpleDemo 的 Maven 项 目 ， 在 pom.xml 中 ， 我 们 将 引入 
RabbitMQ 的 依赖 包 ， 关 键 代 码 如 下 。 


下 <dependency> 

加 <groupId>com.rabbitmq</groupId> 

3 <artifactId>amqp-client</artifactId> 
4 <version>5.3.0</version> 

5 </dependency> 


随后 ， 我 们 开发 一 个 名 为 MsgSenderjava 的 消息 发 送 类 ， 代 码 如 下 。 


// 省 略 必 要 的 package 和 import 代码 
public class MsgSender { 
Public static void main(String[] args) { 
// 初始 化 连接 工厂 
ConnectionFactory connfactory = new ConnectionFactory(); 
// 设 置 连接 工厂 指向 的 目的 地 
connfactory.setHost ("localhost"); 
// 通 过 工厂 创建 消息 连接 
Connection conn = null; 
Channel myChannel = null; 
try { 
conn = connfactory.newConnection(); 
// 通过 消息 连接 创建 通信 通道 
myChannel = conn.createChannel (); 
String qName = "MyQueue"; 
// 通过 通道 创建 一 个 队列 
myChannel .queueDeclare (qName, false, false, false, null); 
// 定 义 消息 
String msg = "This is my First Msg By RabbitMO"; 
// 发 送 消 息 
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2 myChannel .basicPublish("", qName, null, msg.getBytes()); 
22 } catch (IOException e) { 

23 e.printStackTrace (); 

24 } catch (TimeoutException e) { 
25 e.printStackTrace () 7 

26 } 

2 finally{ 

28 // 关闭 通道 和 连接 

29 Ey 

30 if(myChannel!= null){ 

3 下 myChannel .close(); 

3 } 

ek) if(conn != null){ 

34 conn.close(); 

35: } 

36 } catch (IOException e) { 
il e.printStackTrace () 7 

38 } catch (TimeoutException e) { 
39 e.printStackTrace (); 

40 } 

41 1 

42 } 

43 } 


在 上 述 代码 中 ， 我 们 通过 如 下 步骤 实现 了 消息 发 送 的 功能 。 

第 一 步 ， 通 过 第 7 行 代码 设置 连接 工厂 的 目标 地 址 ， 这 里 是 localhost。 

第 二 步 , 通过 第 17 行 代码 使 用 queueDeclare 方法 新 建 一 个 名 为 myQueue 的 通信 队列 (也 叫 消 
息 队列 ) ， 该 方法 的 原型 如 下 。 

1 queueDeclare(String queue, boolean durable, boolean exclusive, boolean 
autoDelete ,Map<String, Object> arguments); 

其 中 ， 第 一 个 参数 表示 队列 名 。 第 二 个 参数 表示 是 否 持久 化 ， 这 里 的 取 值 是 false， 表 示 重 启 
RabbitMQ 后 ， 存 放 在 该 消息 队列 中 的 消息 会 丢失 。 第 三 个 参数 表示 是 否 排外 ， 有 两 个 作用 : 作用 
一 ， 当 连接 关闭 时 (这 里 即 conn 关闭 时 ) ， 该 队列 是 否 会 自动 删除 ; 作用 二 ， 如 果 不 是 排外 的 〈 即 
该 值 是 false) ， 可 以 让 其 他 channel 访问 该 队列 ， 否 则 其 他 channel 不 能 访问 。 从 上 述 分 析 来 看 ， 
由 于 该 参数 是 false， 则 连接 关闭 时 ， 不 会 自动 删除 ， 且 允许 其 他 channel 访问 该 队列 。 第 四 个 参数 
表示 该 队列 中 的 消息 是 否 会 自动 删除 ,这 里 的 取 值 是 false， 如 果 设 置 为 true,， 那么 可 以 通过 第 五 个 
参数 来 定义 自动 删除 的 时 间 点 。 在 使 用 过 程 中 ， 一 般 不 设置 为 自动 删除 ， 所 以 第 五 个 参数 一 般 是 
null。 

第 三 步 ， 通 过 第 21 行 的 basicPublish 方法 发 送 消息 。 该 方法 的 第 一 个 参数 是 交换 器 的 名 称 ， 
这 里 用 到 的 是 匿名 交换 器 ; 第 二 个 参数 是 队列 名 ; 第 三 个 参数 是 路 由 规则 ， 这 里 是 空 ， 第 四 个 参数 
是 待 发 送 的 消息 。 

完成 发 送 后 ， 我 们 需要 在 第 27~41 行 的 finally 从 句 中 关闭 各 种 连接 。 

至 此 ,我们 已 经 把 第 19 行 定 义 的 消息 发 送 到 了 MyQueue 队列 中 。 从 图 9.3 中 ,我们 能 看 到 新 
创建 的 名 为 “MyQueue” 的 消息 队列 ， 而 且 其 中 有 一 条 刚 发 的 状态 是 Ready 的 消息 。 


164 


| Spring Cloud 实战 


| bbRabbitMO ae 思 


Ral 


Overview 。 comeaions ”ciamek Exchanges (EY imin 


Queues 


六 All queues (1) 


Overview Messages Message rates 
Name Features State Ready Unacked Total incoming deliver / get ack 
MyQueue idle 1 0 1 0.00/s 0.00/s 0.00/s 


» Add a new queue 


图 9.3 新 创建 的 消息 队列 
在 下 面 的 MsgReceiver 类 中 ， 我 们 实现 了 接收 消息 的 功能 ， 代 码 如 下 。 


1 // 省 略 必要 的 package 和 import 代码 

2 public class MsgReceiver { 

3 public static void main(String[] argv) { 

4 ConnectionFactory connfactory = new ConnectionFactory(); 

5 connfactory.setHost ("localhost"); 

6 Connection conn = null; 

7 Channel myChannel = null; 

8 Ery. { 

9 conn = connfactory.newConnection(); 

10 conn.createChannel (); 

a myChannel = conn.createChannel (); 

之 String qName = "MyQueue"; 

3 myChannel .queueDeclare (qName, false, false, false, null); 

14 // 创建 消费 者 

15' Consumer consumer = new DefaultConsumer (myChannel) { 

16 @Override 

i Public void handleDelivery (String tag, Envelope env, 
BasicProperties prop, bytel[l] msgBody) { 

18 System.out.println("msg:" + new String (msgBody)); 

19 } 

20 }; 

2 channel .basicConsume (qName, true, consumer); 

22 } catch (IOException e) { 

23 e.printStackTrace (); 

24 } catch (TimeoutException e) { 

2 e.printStackTrace () 7 

26 } 

2 finallyt{ 

28 // 关闭 通道 和 连接 

29 try { 

30 if(myChannel != null){ 

31 myChannel .close(); 

32 } 

3 if(conn != null){ 

34 conn.close(); 

3 和 


36 } catch (IOException e) { 
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37 e.printStackTrace (); 

38 } catch (TimeoutException e) { 

39 e.printStackTrace (); 

40 } 

41 } 

42 } 

43 上 

这 里 ， 通 过 连接 工厂 创建 conn 连接 对 象 的 代码 和 通过 连接 对 象 创建 渠道 (channel) 的 代码 与 
之 前 的 消息 发 送 类 MsgReceiver.java 很 相似 ， 所 以 就 不 再 详细 讲述 了 。 

在 第 15 行 中 ,我 们 构建 了 一 个 Consumer 类 型 的 消费 者 对 象 ， 它 是 连接 到 channel 渠道 的 , 在 
其 中 第 17~19 行 的 handleDelivery 方法 中 ， 我 们 接收 到 了 MsgReceiver 类 通过 MyQueue 队列 发 来 
的 消息 。 这 里 我 们 同样 在 finally 从 句 中 关闭 了 连接 对 象 和 渠道 。 

运行 该 程序 后 ， 能 在 控制 台中 看 到 输出 : “msg:This is my First Msg By RabbitMQ”。 这 说 明 ， 
刚才 我 们 开发 的 消息 发 送 类 和 消息 接收 类 成 功 地 通过 RabbitMQ 中 间 件 创建 的 MyQueue 队列 进行 
了 消息 的 交互 。 


9.2.3 ”Kafka 的 安装 步骤 


Kafka 是 由 LinkedIn 公司 开发 的 一 个 分 布 式 的 消息 中 间 件 系统 。Kafka 具有 分 区 和 复制 的 日 志 
功能 ， 它 还 具有 消息 发 布 和 订阅 功能 。 在 Windows 系统 中 安装 Kafka 的 步骤 如 下 。 

第 一 步 ， 下 载 、 安 装 和 启动 Zookeeper。 

由 于 Kafka 是 分 布 式 的 , 因此 它 需 要 用 Zookeeper 来 管理 。 我 们 到 Zookeeper 官网 的 ( 即 Apache 
网 站 ) http://zookeeper.apache.org/releases.html 页 面 可 以 下 载 到 安装 包 。 解 压缩 安装 包 后 ， 到 conf 
目录 下 找到 zoo_sample.cfg， 把 它 重 命名 为 zoo.cfg。 随 后 在 cmd 命令 窗口 中 ， 到 bin 目录 下 运行 
zkServer.cmd 命令 能 启动 Zookeeper。 之 后 ， 我 们 需要 Zookeeper 一 直 处 于 启动 状态 ， 所 以 不 用 关 
闭 该 窗口 。 

第 二 步 ， 下 载 、 安 装 和 启动 Kafka。 

到 http:/Wkafka.apache.org/downloads.html 页 面 可 以 下 载 安装 包 ， 请 注意 下 载 二 进 制 (Binary) 
文件 ， 别 下 载 源 文件 (Source) 。 

解压 缩 安装 包 后 ， 启 动 cmd 命令 窗口 ， 进 入 安装 目录 ， 运 行 如 下 命令 能 启动 Kafka。 


于 .\bin\windows\kafka-server-start.bat .\config\server.properties 
我 们 可 以 通过 如 下 步骤 检验 Zookeeper 和 Kafka 是 否 成 功 地 安装 和 运行 。 
步骤 014 打开 一 个 新 的 cmd 命令 窗口 ， 通 过 如 下 命令 在 Kafka 系统 中 创建 一 个 名 为 


“myTopic” 的 主题 。 


和 .\bin\windows\kafka-topics.bat --create --zookeeper localhost:2181 
--replication-factor 1 --partitions 1 --topic myTopic 


步骤 024 打开 一 个 新 的 cmd 命令 窗口 ， 通 过 如 下 命令 创建 一 个 消息 的 生产 者 实例 。 请 注意 ， 
该 窗口 不 要 关闭 ， 而 且 这 个 生产 者 是 向 刚才 创建 的 myTopic 主题 中 发 送 消息 的 。 


L kafka-console-producer.bat --broker-list localhost:9092 --topic myTopic 
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步骤 034 打开 一 个 新 的 cmd 命令 窗口 ， 通 过 如 下 命令 创建 一 个 消息 的 消费 者 实例 。 请 注意 ， 
该 消息 实例 也 是 针对 myTopic 主题 的 。 

L kafka-console-consumer.bat --zookeeper localhost:2181 --topic myTopic 

步骤 04 在 创建 完 消息 生产 者 和 消息 消费 者 实例 后 , 大 家 可 以 在 生产 者 的 命令 窗口 中 输入 消 
息 ， 在 按 回 车 键 后 ， 在 消费 者 窗口 中 即 可 看 到 该 消息 。 


9 


9.2.4 通过 Kafka 发 送 和 接收 消息 的 案例 


刚才 我 们 演示 了 以 命令 窗口 的 形式 通过 Kafka 生产 和 消费 消息 的 做 法 , 这 里 我 们 则 是 通过 Java 
代码 发 送 和 接收 消息 。 


步 又 014 新 建 一 个 名 为 KafkaSimpleDemo 的 Java Maven 项 目 ， 在 其 中 的 pom.xml 文件 中 引 
入 Kafka 依赖 包 ， 关 键 代码 如 下 。 


1 <dependency> 

ed <groupId>org.apache.kafka</groupId> 

3 <artifactId>kafka-clients</artifactId> 
4 <version>0.10.1.1</version> 

SS </dependency> 


步骤 024 在 MsgProducerjava 中 实现 发 送 消息 的 功能 ， 代 码 如 下 。 
// 省 略 必 要 的 package 和 import 代码 


public class MsgProducer { 
public static void main(String[] args) throws Exception { 

// 用 于 存储 和 kafka 通信 相关 的 属性 值 
Properties Properties = new Properties(); 

// 指 定 消息 key 序列 化 方式 

properties.put ("key.serializer", 

"org.apache.kafka.common.serialization.StringSerializer"); 

// 指 定 消息 本 身 的 序列 化 方式 

Properties.put ("value.serializer", 

"org.apache.kafka.common.serialization.StringSerializer"); 


10 // 设 置 消息 的 发 送 地 址 


aowmwwm 


wo 


hb Properties.put ("bootstrap.servers", "localhost:9092"); 

12 // 键 和 值 都 是 String 类 型 

13 Producer<String, String> myProducer= new KafkaProducer<String, 
String> (properties); 

14 tryt{ 

15: myProducer.send (new ProducerRecord<String, String> ("myQueue", 
"msgKey", "Hello Kafka")); 

16 System.out.println("Msg sent successfully"); 

hyd } 

18 catch (Exception e){ 

19 e.printSstackTrace (); 

20 } 

2 finallyt{ 

学 if(myProducer!= null){ 


a myProducer.close(); 
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24 } 

25 properties.clear(); 

26 } 

ly } 

28” 中 

在 上 述 代 码 的 第 7~13 行 ， 我 们 通过 properties 对 象 设置 了 生产 消息 的 必要 属性 ， 包 括 消 息 键 


和 值 的 序列 化 方式 和 发 送 地 址 。 这里， 由 于 消息 的 键 和 值 都 是 String 类 型 的 ， 因 此 序列 化 的 方式 都 
是 基于 String 的 。 
在 完成 设置 属性 后 , 我 们 通过 第 15 行 的 send 方法 发 送 消 息 , 通过 该 方法 的 第 一 个 参数 指定 了 
消息 的 主题 ， 通 过 第 二 个 和 第 三 个 参数 指定 了 消息 的 键 和 值 。 在 第 21~26 行 的 finally 从 句 中 ， 我 
们 关闭 了 用 于 发 送 消息 的 myProducer 对 象 以 及 存放 属性 值 的 properties 对 象 。 

运行 上 述 代 码 ， 即 可 向 “myQueue” 发 送 一 条 “Hello Kafka” 的 消息 。 

在 下 面 的 MsgConsumer.java 代码 中 ， 我 们 将 实现 接收 消息 的 功能 ， 代 码 如 下 。 


1  // 省 略 必要 的 package 和 import 代码 
2 public class MsgConsumer { 
3 public static void main(String[] args) { 
4 Properties Properties = new Properties(); 
5 // 从 这 个 地 址 接收 消息 ， 和 生产 者 的 一 致 
6 Properties.put ("bootstrap.servers", "localhost:9092"); 
// 需 要 指定 消费 组 
8 Properties.put ("group.id", "myKafka"); 
9 Properties.put ("key.deserializer", 
"org.apache.kafka.common.serialization.StringDeserializer"); 
10 Properties.put ("value.deserializer", 
11 "org.apache.kafka.common.serialization.StringDeserializer"); 
全 之 KafkaConsumer<String, String> myConsumer = 
new KafkaConsumer<String, String> (properties); 
3 myConsumer .subscribe (Collections.singletonList ("myQueue")); 
14 tr 
5 ConsumerRecords<String, String> consumeRecords = 
myConsumer .pol1(1000) 
16 for (ConsumerRecord<String, String> oneRecord : 
consumeRecords){ 
yy // print the key and value for the consumer records. 
18 System.out.printf("key is: " + oneRecord.key()); 
19 System.out .printf ("value is: " + oneRecord.value()); } 
20 
2 catch (Exception e){ 
22 e.printStackTrace(); 
23 } 
24 finally{ 
25 if(myConsumer != null){ 
26 myConsumer.close(); 
2 } 
28 properties.clear(); 
29 
30 
2 


在 接收 消息 时 ， 我 们 需要 通过 第 8 行 代码 指定 消息 的 消费 者 组 ， 这 里 的 消费 者 组 和 消息 主题 
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不 是 一 个 概念 。 之 后 ， 我 们 通过 第 9 行 和 第 10 行 代码 指定 待 接收 消息 键 和 值 的 序列 化 方式 ， 这 里 
也 是 基于 String 类 型 的 。 请 注意 ， 这 里 第 6 行 指定 接收 消息 的 地 址 需要 和 生产 者 代码 中 的 一 致 。 
在 第 12 行 中 ,我 们 创建 了 一 个 消费 者 对 象 ;在 第 13 行 中 ,我 们 让 这 个 消费 者 对 象 从 myQueue” 
消息 主题 中 订阅 消息 。 这 里 的 消息 主题 需要 和 之 前 发 送 消息 的 主题 名 一 致 。 
在 完成 消息 订阅 后 ， 我 们 通过 第 15~19 行 的 代码 ， 从 消息 主题 中 得 到 消息 并 输出 到 控制 台 上 。 
同样 的 ， 在 第 24 行 的 finally 从 名 中， 我 们 关闭 了 相关 资源 。 
从 这 个 案例 中 ， 我 们 能 看 到 基于 “订阅 ”模式 的 Kafka 消息 接收 和 发 送 的 做 法 : 消息 生产 者 
向 消息 主题 中 发 送 消 息 ， 而 消费 者 则 是 通过 上 述 第 13 行 代码 订阅 (subscribe) 消息 主题 ， 并 通过 
第 15 行 代码 获取 消息 主题 中 的 消息 。 


9.3 ”通过 消息 总 线 封装 消息 中 间 件 


消息 总 线 (Spring Cloud Bus) 是 Spring Cloud 体系 中 用 于 实现 模块 间 通 信 的 一 个 微服 务 框 架 ， 
它 对 消息 中 间 件 ( 比 如 RabbitMQ 或 Kafka) 做 了 层 封装 。 在 这 部 分 的 案例 中 ， 微 服务 系统 中 的 消 
息 是 通过 消息 总 线 发 送 到 各 相应 节点 的 ， 也 就 是 说 ， 消 息 总 线 对 消息 中 间 件 做 了 层 封 装 。 

前 面 我 们 讲述 了 通过 Spring Cloud Config 组 件 从 配置 服务 器 (比如 Git 服务 器 ) 获取 配置 信息 
的 做 法 ， 这 里 我 们 将 通过 消息 总 线 实现 “配置 更 改 后 能 动态 刷新 ”的 效果 。 


9.3.1 基于 RabbitMQ 的 消息 总 线 案例 


在 8.4 节 讲 述 的 Spring 与 Eureka 整合 的 案例 中 ， 如 果 我 们 在 Git 服务 器 上 更 改 了 连接 数据 库 的 配 
置信 息 ， 那 么 可 以 在 配置 客户 端 发 起 post 格式 的 refresh 请 求 ， gh 
在 实际 的 项 目 中 ， 出 于 提升 可 用 性 的 考虑 ， 我 们 往往 把 同一 套 服务 部 署 在 多 台 服 务 器 上 ， 
果 我 们 逐一 在 每 台 机 器 上 发 起 post 格式 的 refresh， 效 率 未 免 过 低 ， 而 且 容易 遗忘 。 We 
我 们 可 以 通过 消息 总 线 来 实现 动态 刷新 的 功能 ， 有 具体 的 框架 如 图 9.4 所 示 。 


[ Post 形式 的 bus7refresp 请 荡 ] 


spring cloud bus 


配置 客户 端 配置 客户 端 


图 9.4 基于 消息 总 线 动 态 刷新 的 框架 图 


从 图 9.4 中 ,我 们 能 看 到 ， 由 于 post 请 求 是 带 有 bus 前 级 的 ， 因 此 会 发 送 到 消息 总 线 上 ; 由 于 
配置 客户 端 与 消息 总 线 相连 ， 因 此 post 请 求 会 通过 消息 总 线 发 送 到 所 有 需要 动态 获取 新 值 的 配置 
客户 端 上 。 我 们 将 在 8.4 节 案 例 的 基础 上 ， 通 过 如 下 改动 实现 基于 RabbitMQ 的 消息 总 线 的 案例 。 

改动 点 1: 在 EurekaConfigClient 项 目的 pom.xml 文件 中 增加 amqp 的 依赖 包 。 这 是 因为 
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RabbitMQ 是 基于 amqp 协议 的 。 


| <dependency> 

bd <groupId>org.springframework.cloud</groupId> 

2 <artifactId>spring-cloud-starter-bus-amqp</artifactId> 
4 </dependency> 


改动 点 2: 在 application.yml 中 增加 如 下 针对 rabbitmq 的 配置 。 


浊 spring: 

多 rabbitmq: 

由 host: localhost 

4 Port: 5672 

5 username: 你 机 器 上 rabbitmq 的 用 户 名 
6 Password: 你 机 器 上 rabitmq 的 密码 


上 述 配 置 需要 和 安装 rabbitmq 时 设置 的 参数 一 致 。 
完成 上 述 修改 ， 启 动 EurekaConfigServer 和 EurekaConfigClient 两 个 项 目 后 ， 能 在 后 者 的 控制 
台中 看 到 /bus/refresh 的 请 求 ， 如 图 9.5 所 示 ， 请 注意 该 请 求 是 post 格式 的 。 


ointHandlerMapping 3 [/loggers/{name: .*}] ,mechods=[Gl 
ointHandlerMapping : Mapped [/loggers/ {name: .*} 


ointHandlerMapping : Mapped [/1oggezs /1oggezs .json] ,meth 
ointHandlerMapping : Mapped "{[/bus/env],methods=[POST]}" ontq 
ointHandlerMapping : Mapped "i{[/bus/refresh],methods=[POST]}" 


图 9.5 启动 配置 客户 端 后 能 看 到 /bus/refresh 请 求 
随后 ， 我 们 修改 Git 服务 器 上 的 配置 后 ， 可 以 用 postman 或 soapUI 等 工具 发 送 post 格式 的 


http://localhost:8899/bus/refresh 请 求 ， 这 样 配置 客户 端 即 可 从 消息 总 线 上 得 到 该 post 请 求 并 完成 动 
态 刷新 的 动作 。 


9.3.2 ”基于 Kafka 的 消息 总 线 案例 


在 9.3.1 小 节 ， 消 息 总 线 是 基于 RabbitMQ 的 ， 我 们 可 以 通过 如 下 修改 实现 基于 Kafka 的 消息 
总 线 。 

修改 点 1: 在 EurekaConfigClient 项 目的 pom.xml 文件 中 增加 Kafka 的 依赖 包 ， 代 码 如 下 。 这 
样 ， 该 项 目 就 能 包含 基于 Kafka 的 消息 总 线 了 。 


i <dependency> 

4 <groupId>org.springframework.cloud</groupId> 

3 <artifactId>spring-cloud-starter-bus-kafka</artifactId> 
4 </dependency> 


修改 点 2: 在 application.yml 中 引入 针对 Kafka 的 配置 。 同 样 ， 这 需要 和 Kafka 安装 时 的 配置 
完全 一 致 。 
spring: 
cloud: 


pa 
3 Stream: 
4 kafka: 
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3 binder: 
6 zk-nodes: localhost:2181 
A brokers: localhost:9092 


9.4 _ Spring Cloud Stream 组 件 的 常见 用 法 


在 实际 的 项 目 中 ，Spring Cloud Stream 组 件 提供 的 便利 : 第 一 ， 开 发 者 能 通过 绑 定 器 (Binder) 
在 相应 模块 间 传 递 消息 ; 第 二 ， 开 发 者 能 通过 该 组 件 提供 的 “发 布 订阅 ”模块 用 较 小 的 代价 定义 针 
对 具体 业务 场景 的 消息 传递 模块 ; 第 三 , 在 一 些 类 似 观察 者 模式 的 场景 中 , 开发 者 还 能 利用 该 组 件 
提供 的 “消费 组 ”实现 “一 条 消息 发 送 到 多 个 接收 模块 ”的 效果 。 


9.4.1 实现 基于 RabbitMQ 的 案例 


代码 \ 第 9 章 \SpringCloudStreamProducer 视频 \ 第 9 章 \ 基 于 RabbitMQ 的 SpringCloudStream 
代码 \ 第 9 章 \SpringCloudStreamConsumer 案例 
在 SpringCloudStreamProducer 这 个 Maven 项 目 中 ， 我 们 可 以 通过 如 下 步骤 编写 发 送 消息 的 功 
能 。 


步 又 014 在 pom.xml 中 引入 Spring Cloud Stream 的 依赖 包 ， 它 是 基于 RabbitMQ 的 ， 关 键 代 
码 如 下 。 
<dependency> 
<groupId>org.springframework.cloud</groupId> 
<artifactId>spring-cloud-starter-stream-rabbit</artifactId> 
</dependency> 
步骤 02 和 在 ProducerApp 启动 类 中 ， 通 过 第 3 行 的 @EnableBinding 注解 绑 定 消息 发 送 类 是 
MsgSender， 同 时 指定 消息 是 通过 Spring Cloud Stream 提供 的 Source 接口 发 送 的 ， 代 码 如 下 。 


心 w IN 


// 省 略 必 要 的 package 和 import 代码 
@SpringBootApplication 
@EnableBinding (value = {MsgSender.class, Source.class}) 
Public class ProducerApp { 
public static void main(String[] args) { 
SpringApplication.run (ProducerApp.class, args); 
} 


oamwmwwm 


} 
步骤 03 编写 实现 发 送 消息 功能 的 MsgSender 类 ， 代 码 如 下 。 
// 省 略 必 要 的 package 和 import 代码 


@EnableBinding (Source.class) 
Public class MsgSender { 
// 通 过 注解 引入 消息 发 送 渠道 


@Autowired 


必 mw N 
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6 Qoutput (Source .OUTPUT) 

gh Private MessageChannel channel; 

8 // 发 送 消息 的 方法 

9 Public void send(String msg) { 

10 channel .send (MessageBuilder.withPayload (msg) .build()); 
TL } 

i200 


其 中 ， 我 们 在 第 7 行 定义 了 发 送 消息 的 渠道 对 象 ， 通 过 第 6 行 的 注解 能 看 到 该 渠道 其 实 就 是 
Source.OUTPUT 输出 队列 。 
在 第 9 行 的 send 方法 中 ， 我 们 是 通过 第 10 行 的 channel.send 方法 实现 发 送 消息 功能 的 。 请 注 
意 ， 这 里 我 们 无 法 直接 创建 消息 ， 应 当 采 用 MessageBuilder 类 的 build 方法 来 创建 消息 。 
步骤 044 在 application.yml 中 编写 针对 Spring Cloud Stream 的 配置 ， 具 体 代码 如 下 。 


server: 
port: 1111 
spring: 
application: 
name: msgSender 
rabbitmq: 
host: localhost 
port: 5672 
9 username: 你 机 器 上 rabbitmq 的 用 户 名 
10 password: 你 机 器 上 rabbitmq 的 密码 
bes cloud: 


oawmwewm 


了 2 stream: 

13 bindings: 

14 output: 

15 destination: myChannel 


在 第 2 行 的 代码 中 , 我 们 指定 了 该 服务 的 工作 端口 是 1111; 在 第 6~10 行 代码 中 , 我 们 指定 了 
RabbitMQ 的 配置 参数 ， 这 和 我 们 安装 时 的 配置 完全 一 致 。 在 第 11~15 行 代码 中 ， 我 们 指定 了 消息 
的 发 送 队 列 名 是 myChannel。 


步骤 054 在 Controller 控制 器 中 ， 我 们 提供 外 部 调用 消息 发 送 功能 的 接口 ， 代 码 如 下 。 


1 “// 省 略 必要 的 Package 和 import 代码 

2  @RestController 

3 Public class Controller { 

4 @Autowired 

5 private MsgSender msgSender; 

6 @RequestMapping ("/send/{msg}") 

7 Public void send(@PathVariable("msg") String msg){ 
8 msgSender .send (msg) 7 

9 } 

L000 


通过 第 6 行 的 注解 , 我们 能 看 到 ， /send/{msg} 请 求 会 触发 第 7 行 的 send 方法 , 而 在 该 方法 中 ， 
会 通过 第 8 行 的 代码 ， 使 用 msgSender.send 方法 发 送 消息 。 
在 SpringCloudStreamConsumer 项 目 中 ， 我 们 将 开发 接收 消息 的 代码 ， 有 具体 步骤 如 下 。 
步骤 01 同样 在 pom.xml 中 引入 基于 RabbitMQ 的 Spring Cloud Stream 依赖 包 ， 这 部 分 代码 
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和 SpringCloudStreamProducer 完全 一 致 ， 所 以 就 不 再 给 出 了 。 
步骤 024 在 启动 类 ConsumerApp 中 ， 我 们 也 是 通过 @EnableBinding 注解 指定 消息 接收 类 和 
消息 接收 渠道 的 ， 代 码 如 下 。 


// 省 略 必要 的 package 和 import 代码 
QSpringBootRAPP1ication 
@EnableBinding (value = {MsgReceiver.class, Sink.class}) 
Public class ConsumerApp { 
public static void main(String[] args) { 
SpringApplication.run(ConsumerApp.class, args); 


} 


oamwmwewnP 


} 
通过 第 3 行 代码 ， 我 们 能 看 到 消息 接收 类 是 MsgReceiver， 这 里 采用 了 Sink 默认 的 渠道 来 接 
收 消息 。 


步骤 034 开发 消息 接收 类 MsgReceiver， 代 码 如 下 。 请 注意 ， 这 里 我 们 通过 第 3 行 的 注解 指 
定 了 消息 接收 渠道 是 Sink.INPUT。 


1  @EnableBinding(Sink.class) 

多 Public class MsgReceiver { 

3 QStreamListener (Sink.INPUT) 

4 Public void receive (Message<String> message) { 

四 System.out .Println("The msg is:" + 
JSONObject .toJSONString (message)) 7 

6 | 

| 

步骤 044 在 application.yml 文件 中 指定 接收 消息 的 配置 信息 ， 代 码 如 下 。 

5 server: 

2 POrts 2222 

3 spring 

4 application: 

name: MsgConsumer 

6 cloud: 

7 stream: 

8 bindings: 

9 input: 

10 destination: myChannel 


其 中 ， 我 们 通过 第 6~10 行 代码 指定 是 从 myChannel 队列 中 接收 消息 的 。 
在 上 述 消息 发 送 模 块 里 ， 我 们 用 到 了 Spring Cloud Stream 框架 提供 的 Source 接口 ， 它 的 底层 
实现 代码 如 下 。 


1 public interface Source { 
String OUTPUT = "output"; 
Qoutput (Source .OUTPUT) 
MessageChannel outpPut () 

1 


也 就 是 说 ， 我 们 通过 @ EnableBinding 注解 引入 该 接口 ， 即 可 使 用 Source 接口 提供 的 output 
输出 队列 ， 具 体 而 言 ， 消 息 会 通过 output 发 送 到 消息 中 间 件 。 


wo 心 ww N 
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同样 的 ， 在 接收 模块 中 ， 我 们 使 用 了 Sink 接口 ， 它 也 是 Spring Cloud Stream 提供 的 ， 它 的 底 
层 实现 代码 如 下 。 


1 public interface Sink { 
String INPUT = "input"; 
@Input (Sink.INPUT) 
SubscribableChannel input(); 
上 


在 接收 模块 中 ， 通 过 Sink 接口 中 的 input 队列 连接 到 消息 中 间 件 ， 由 此 接收 消息 。 

至 此 ， 我 们 完成 了 发 送 和 接收 消息 的 代码 。 依 次 启动 这 两 个 项 目 ， 并 在 浏览 器 中 输入 
“localhost:1111/send/hello ”, 就 可 以 在 SpringCloudStreamConsumer 项 目的 控制 台中 看 到 如 下 输出 。 
这 说 明 ， 我 们 通过 Spring Cloud Stream 组 件 成 功 地 实现 了 两 个 模块 之 间 的 消息 传递 。 

The msg 
is:{"headers":{"amqp receivedDeliveryMode":"PERSISTENT","amqp_receivedRoutingK 
ey":"myChannel", "amqp receivedExchange":"myChannel","amqp deliveryTag":1,"amqp 
_CconsumerQueue":"myChannel .anonymous .pCHDPcc5Qsa7JvioJ-Q6rg", "amqp_redelivered 
":false,"id":"5f0d2c08-51e7-a004-b6bd-8ec96161lef9","amqp consumerTag":"amq.ct 
ag-x25NfIMvVXLZVYWb1IwJTA", "contentType":"text/plain","timestamp":153601686223 
4},"payload":"hello"} 


AOND 


9.4.2 ”通过 更 换 绑 定 器 变更 消息 中 间 件 


在 9.4.1 小 节 的 案例 中 ， 我 们 通过 绑 定 器 在 Spring Cloud Stream 框架 中 连接 上 了 RabbitMQ， 
随后 两 个 项 目 是 通过 Sink.Input 和 Source.Output 两 个 渠道 连接 上 myChannel 队列 的 ， 以 此 实现 了 
通信 的 效果 ， 具 体 的 结构 如 图 9.6 所 示 。 


生产 者 消费 者 


INPUT UTPUT 


1 
消息 中 间 件 | 
[” 浓 电 中间 件 的 功能 模块 | | 

1 


一 一 一 一 一 


图 9.6 Spring Cloud Stream 框架 消息 发 送 示意 图 


从 图 9.6 中 ， 我 们 能 够 看 到 ，Spring Cloud 体系 中 的 模块 〈 比 如 生产 者 和 消费 者 模块 ) 并 不 是 
直接 和 消息 中 间 件 〈 比 如 RabbitMQ) 交互 的 ， 而 是 通过 绑 定 器 ， 换 句 话说 ， 绑 定 器 向 功能 模块 屏 
蔽 掉 了 不 同 消息 中 间 件 的 差异 ， 使 得 功能 模块 能 关注 于 业务 本 身 ， 而 无 须 关注 消息 发 送 的 细节 。 

正 因为 引入 了 绑 定 器 ， 我 们 可 以 用 较 小 的 代价 用 Kafka 这 个 消息 中 间 件 替换 掉 RabbitMQ， 通 
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改动 点 1: 在 生产 者 和 消费 者 两 个 项 目的 pom.xml 中 ， 用 Kafka 的 依赖 包 替 换 掉 RabbitMQ 的 
依赖 包 ， 关 键 代 码 如 下 。 


<dependency> 

2 <groupId>org.springframework.cloud</groupId> 

过 <artifactId>spring-cloud-starter-stream-kafka</artifactId> 

4 </dependency> 

改动 点 2: 在 生产 者 项 目的 配置 文件 中 ， 去 掉 关 于 RabbitMQ 的 相关 配置 ， 加 入 如 下 Kafka 的 
配置 信息 ， 关 键 代码 如 下 。 

为 了 节省 篇 幅 ， 这 里 给 出 properties 格式 的 配置 ， 大 家 可 以 自行 转换 成 yml 格式 的 ， 这 些 参数 
需要 和 安装 Kafka 时 的 配置 一 致 。 

1 spring.cloud.stream.kafka.binder.brokers=localhost :9092 

ee spring.cloud.stream.kafka.binder.zk-nodes=localhost:2182 

3 spring.cloud.stream.bindings.output.destination=myChannel 

改动 点 3: 在 消费 者 项 目的 配置 文件 中 ， 也 是 用 Kafka 的 配置 替换 掉 原来 RabbitMQ 的 ， 关 键 
代码 如 下 。 


1 spring.cloud.stream.kafka.binder.brokers=localhost:9092 

2 spring.cloud.stream.kafka.binder.zk-nodes=localhost:2182 

3 spring.cloud.stream.bindings.input.destination=myChannel 

和 生产 者 项 目的 配置 文件 相 比 ， 差 别 在 第 3 行 ， 这 里 是 定义 input 的 队列 ， 而 生产 者 项 目 中 定 
义 的 是 output 的 队列 。 


9.4.3 ”消费 组 案例 演示 


在 前 文 提 到 ， 如 果 我 们 把 多 个 消息 接收 实例 放 到 同一 个 消费 组 中 ， 当 消息 到 达 时 ， 该 消息 组 
中 只 会 有 一 个 实例 接收 并 处 理 消 息 。 本 小 节 将 在 9.4.1 小 节 案 例 的 基础 上 ， 通 过 如 下 修改 实现 消息 
组 的 效果 。 

修改 点 一 : 在 SpringCloudStreamProduct 项 目的 application.yml 配置 文件 中 增加 关于 消费 组 的 
配置 ， 关 键 代码 如 下 。 


nb spring: 

之 cloud: 

3 stream: 

4 bindings: 

5 input: 

6 group: myChannelGroup 
1 destination: myChannel 


通过 第 6 行 代码 指定 了 该 消息 接收 实例 所 在 的 分 组 是 myChannelGroup， 通 过 第 7 行 代码 指定 
了 该 实例 是 从 myChannel 队列 上 接收 消息 的 ， 这 是 因为 在 SpringCloudStreamProducer 消息 发 送 实 
例 中 ， 也 是 向 myChannel 队列 发 送 消息 的 。 

修改 点 二 :新 建 名 为 SpringCloudStreamConsumerSameGroup 的 Maven 项 目 , 该 项 目的 pom.xml 
文件 以 及 所 有 Java 类 均 和 SpringCloudStreamConsumer 项 目 一 样 ， 唯 一 的 差别 是 application.yml 文 
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件 ， 该 配置 文件 的 代码 如 下 。 


Server: 
Bort 2233 
spring: 
application: 
name: MsgConsumerSameGroup 
cloud: 
stream: 
bindings: 
input: 
group: myChannelGroup 
destination: myChannel 


上 


PPioowanwmwwn 


0 
1 

在 第 2 行 中 ， 我 们 更 改 该 项 目的 工作 端口 为 2233， 在 第 5 行 中 ， 更 改 项 目的 名 字 ， 其 他 部 分 
的 代码 和 SpringCloudStreamConsumer 项 目 一 致 ， 该 消息 接收 实例 的 分 组 同样 是 myChannelGroup， 
同样 是 从 myChannel 队列 中 获得 消息 的 。 

完成 上 述 改 动 后 ， 依 次 启动 SpringCloudStreamProduct 、SpringCloudStreamConsumer 和 
SpringCloudStreamConsumerSameGroup 三 个 项 目 , 并 在 浏览 器 中 多 次 输入 “http://localhost:1111/send/hello”。 
此 时 , 我 们 会 发 现 每 次 发 送 的 消息 不 会 同时 出 现在 两 个 接收 实例 的 控制 台中 , 每 次 只 会 出 现在 一 个 
接收 实例 中 。 


9.4.4 消息 分 区 实例 演示 


在 刚才 给 出 的 消息 组 的 案例 中 ， 被 编 在 同一 个 组 内 的 消息 接收 实例 是 以 轮 询 的 方式 接收 并 处 
理 消 息 的 。 但 在 一 些 场景 中 , 我们 需要 让 具备 某 种 属性 的 消息 一 直 被 同一 个 消息 实例 来 处 理 ， 这 时 
我 们 就 可 以 通过 消息 分 区 来 实现 这 个 效果 。 

而 且 ， 在 之 前 的 案例 中 ， 我 们 在 不 同 的 模块 间 是 传送 一 个 字符 串 ， 在 大 多 数 场景 中 ， 我 们 需 
要 传输 自 定 义 的 类 型 ， 在 这 个 案例 中 ， 同 样 将 演示 这 一 效果 。 这 部 分 代码 是 根据 9.4.3 小 节 的 案例 
改写 而 成 的 。 

修改 点 一 : 在 SpringCloudStreamProducer 项 目的 MsgSender 类 中 新 增 一 个 sndAccount 方法 ， 
代码 如 下 。 

1 // 省 略 必要 的 package 和 import 代码 


2 @EnableBinding (Source.class) 

3 public class MsgSender { 

4 @Autowired 

5 @Output (Source .OUTPUT) 

6 private MessageChannel channel; 

h Public void send (String msg) { 

8 channel .send (MessageBuilder.withPayload (msg) .build()); 
9 二 

10 Public void sendAccount (Account account) { 

ji channel.send (MessageBuilder.withPayload (account) .build()); 
12 } 

| 


在 第 10~12 行 代 码 的 sendAccount 方法 中 ， 我 们 将 传输 由 参数 传 入 的 Account 对 象 。Account 
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类 的 定义 如 下 ， 其 中 包含 id 和 name 属性 。 


1 public class Account implements Serializable { 
Private int id; 

3 Private String name; 

4 // 省 略 对 应 的 get 和 set 方法 

| 


修改 点 二 : 在 SpringCloudStreamProducer 项 目的 控制 器 类 Controllerjava 中 新 增 sendAccount 
方法 ， 通 过 调用 该 方法 ， 用 户 能 实现 发 送 Account 类 型 对 象 的 效果 。 


@RequestMapping ("/sendAccount") 

public void sendAccount (){ 
// 创 建 一 个 id 是 1 的 Account 类 型 的 对 象 
Account acc = new Account(); 
acc.setId(1); 
acc.setName ("Peter"); 
// 发 送 该 对 象 

msgSender.sendAccount (acc) 7 


} 


修改 点 三 : 在 SpringCloudStreamProducer 项 目的 application.yml 文件 中 配置 关于 消息 分 区 的 参 
数 ， 关 键 代码 如 下 。 


oamwm 必 wm 


让 spring: 

志 cloud : 

3 stream: 

4 bindings: 

人 output: 

6 destination: myChannel 

7 content-type: application/json 

8 Producer: 

9 PartitionKeyExpression: payload.id 
10 PartitionCount: 2 


由 于 本 次 我 们 将 要 传输 自 定义 类 型 的 Account 对 象 , 因此 需要 在 第 7 行 中 设置 传输 格式 。 在 第 
9 行 中 , 我们 设置 了 将 根据 payload.id 进行 分 组 , 由 于 payload 是 Account 类 型 的 , 而 传输 的 Account 
对 象 的 这 是 1， 因 此 该 消息 将 始终 被 索引 号 是 1 的 消费 实例 接收 并 处 理 。 在 第 10 行 中 ， 指 定 了 该 
消息 分 区 中 的 实例 数 是 2。 

修改 点 四 :在 SpringCloudStreamConsumer 和 SpringCloudStreamConsumerSameGroup 两 个 消息 
接收 实例 项 目的 MsgReceiver 类 中 新 增 一 个 接收 并 处 理 Account 类 型 对 象 的 receiveAccount 方法 ， 
代码 如 下 。 


和 QStreamListener (Sink.INPUT) 

2 Public void receiveAccount (Message<Account> message) { 

加 System.out .Println("The account msg is:" + 
message.getPayload() .getName ()); 

a } 


该 方法 同样 是 从 Sink.INPUT 中 得 到 消息 的 ， 由 于 传 来 的 消息 是 Account 类 型 的 ， 因 此 该 方法 
的 参数 是 Message<Account> 类 型 的 ,在 该 方法 的 第 3 行 中 ,我 们 输出 了 该 Account 类 型 对 象 的 name。 
同样 ， 我 们 需要 在 这 两 个 消息 接收 实例 的 项 目 中 增加 关于 Account 类 的 定义 ， 该 类 的 代码 和 
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SpringCloudStreamProducer 项 目 中 的 完全 一 致 。 
修改 点 五 : 在 SpringCloudStreamConsumer 项 目的 application.yml 文件 中 增加 关于 消息 分 区 的 
配置 ， 关 键 代码 如 下 。 


于 spring: 

2 cloud: 

3 stream: 

4 bindings: 

5 input: 

6 group: myChannelGroup 
~ destination: myChannel 
8 consumer: 

9 partitioned: true 

3 instanceCount: 2 
instanceIndex: 1 


0 
1 
其 中 ， 在 第 9 行 中 开启 了 消息 分 区 模式 ; 在 第 10 行 中 指定 了 该 消息 分 区 中 实例 的 数量 是 2， 
这 需要 和 在 消息 生产 者 项 目 中 的 数量 一 致 ， 在 第 11 行 指定 了 SpringCloudStreamConsumer 消息 接 
收 实例 在 消息 分 区 中 的 索引 号 是 1。 
修改 点 六 : 在 SpringCloudStreamConsumerSameGroup 项 目的 application.yml 文件 中 ， 依 照 上 
述 修改 点 五 设置 关于 消息 分 区 的 配置 ， 但 需要 把 其 中 的 instanceIndex 改 成 0。 
依次 启动 上 述 三 个 项 目 ， 然 后 在 浏览 器 中 多 次 输入 “http://localhost:1111/sendAccount”。 
我 们 能 发 现 ， 该 消息 始终 会 被 SpringCloudStreamConsumer 处 理 。 这 是 因为 ， 在 生产 者 实例 的 
application.yml 文件 中 , 我 们 通过 partitionKeyExpression 指定 了 配送 消息 的 规则 是 payload.id, 所 以 
我 们 只 会 在 索引 号 (instanceIndex) 是 1 的 SpringCloudStreamConsumer 实例 的 控制 台中 看 到 定义 
在 receiveAccount 方法 中 的 输出 结果 。 


9.5 本 章 小 结 


本 章 首先 通过 消息 中 间 件 实现 了 在 模块 间 相互 通信 的 功能 ， 由 此 向 大 家 展示 了 消息 总 线 技术 
在 项 目 中 的 常见 用 法 ， 并 在 此 基础 上 通过 案例 讲述 了 消息 驱动 框架 在 微服 务 体系 中 的 作用 。 

在 架构 师 这 个 层面 上 ， 我 们 需要 关注 微服 务 体系 中 的 消息 发 送 和 存储 的 模式 ， 以 及 通过 消息 
机 制 整合 诸多 模块 的 架构 ， 而 不 是 消息 发 送 的 底层 实现 。 本 章 在 讲述 消息 机 制 和 消息 框架 时 ， 也 是 
绕 架 构 师 层面 的 需求 来 讲解 的 ， 请 大 家 在 阅读 本 章 时 务必 着 重 体 会 这 点 。 


第 10 章 
微服 务 健康 检查 与 服务 跟踪 


当 基于 Spring Cloud 的 微服 务 上 线 后 ， 我 们 可 以 通过 Spring Boot Admin 组 件 监控 系统 的 健康 
情况 ， 同 时 还 可 以 使 用 邮件 报警 机 制 。 而 且 ， 系 统 运行 时 难免 会 出 现 问题 ， 所 以 在 微服 务 系统 的 运 
行 过 程 中 ， 我 们 可 以 通过 Sleuth 服务 跟踪 组 件 输出 各 服务 之 间 的 调用 关系 ， 这 样 一 旦 出 现 了 问题 ， 
我 们 就 能 很 快 地 定位 和 排查 。 

我 们 能 够 通过 Sleuth 输出 所 有 系统 的 运行 日 志 ， 如 果 单 纯 通 过 人 工 的 方式 提取 出 我 们 感 兴 
的 内 容 ， 工 作 量 可 能 会 非常 大 ， 这 时 我 们 就 可 以 整合 Zipkin 组 件 ， 这 样 不 仅 可 以 直观 地 查看 整个 
调用 链 路 的 信息 ， 而 且 可 以 把 调用 信息 存储 到 数据 库 ， 以 便 事后 查询 。 


10.1 通过 Spring Boot Admin 监控 微服 务 


在 第 1 章 中 , 我 们 分 析 了 通过 Actuator 监控 微服 务 运行 情况 的 一 般 做 法 ,通过 调用 Actuatorde 
接口 ， 我 们 可 以 看 到 虚拟 机 内 存 、 线 程 以 及 类 加 载 的 事实 指标 。 

通过 Spring Boot Admin， 我 们 可 以 用 图 形 化 的 形式 更 直观 地 看 到 微服 务 系统 运行 时 的 各 项 指 
标 ， 从 而 能 更 有 效 、 快 速 地 发 现 并 解决 问题 。 


10.1.1 监控 单个 服务 


代码 位 置 视频 位 置 
代码 \ 第 十 章 \SpringCloudAdminDemo 视频 \ 第 十 章 \ 监 控 单个 服务 
代码 \ 第 十 章 \SpringCloudAdminClient 


下 面 将 演示 通过 Spring Boot Admin 监控 单个 应 用 ， 在 SpringCloudAdminDemo 项 目 中 引入 服 
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务 端的 代码 ， 具 体 的 开发 步骤 如 下 。 
步 又 014 创建 Maven 项 目 ， 并 在 pom.xml 中 引入 Spring Cloud Admin 服务 端 和 图 形 界面 相 


关 的 依赖 包 ， 关 键 代码 如 下 。 


<dependency> 

<groupId>de.codecentric</groupId> 
<artifactId>spring-boot-admin-server</artifactId> 
<version>1.5.7</version> 

</dependency> 

<dependency> 
<groupId>de.codecentric</groupId> 
<artifactId>spring-boot-admin-server-ui</artifactId> 
<version>1.5.7</version> 

0 </dependency> 


步 又 024 在 application.yml 中 指定 该 项 目的 工作 端口 为 9000， 代 码 如 下 。 


站 server: 
2 port: 9000 


7 


Powawmn 上 wm 


步骤 034 在 启动 类 Appjava 中 ,通过 @EnableAdminServer 注解 指定 该 项 目 是 Admin 服务 端 ， 


代码 如 下 。 
// 省 略 必 要 的 package 和 import 代码 


@EnableAutoConfiguration 

@EnableAdminServer 

Public class App{ 
public static void main( String[] args ){ 
SpringApplication.run (App.class, args); 


OIA 


} 


启动 该 项 目 ， 并 在 浏览 器 中 输入 localhost:9000， 能 够 看 到 Spring Boot Admin 的 界面 如 图 
所 示 。 从 界面 上 我 们 能 够 看 到 ， 尚 未 有 可 监控 的 项 目 。 


ERNGNS ounnvL 


+ /URL Version info ss 


图 10.1 Spring Boot Admin 图 像 化 界面 的 效果 图 


10.1 


为 了 演示 Spring Boot Admin 监控 具体 微服 务 的 效果 ， 我 们 需要 开发 客户 端的 代码 ， 具 体 的 步 


又 如 下 。 


步骤 014 创建 名 为 SpringCloudAdminClient 的 Maven 项 目 , 并 在 pom.xml 中 引入 Spring Boot 


Admin 客户 端的 依赖 包 ， 关 键 代码 如 下 。 
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<dependency> 
<groupId>de.codecentric</groupId> 
<artifactId>spring-boot-admin-starter-client</artifactId> 
<version>1.5.7</version> 
</dependency> 


步 又 024 在 application.yml 中 指定 该 客户 端 项 目的 工作 端口 为 9020, 并 指定 该 客户 端 所 对 应 
的 服务 端 url 为 http://localhost:9000， 代 码 如 下 。 


wo 必 wN 


server: 
port: 9020 
spring: 
boot: 
admin: 
url: http://localhost:9000 
management: 
security: 
enabled: false 


通过 第 7~9 行 代码 , 我 们 指定 了 访问 该 项 目 时 无 须 安全 验证 。 这 样 , 我 们 在 后 面 localhost:9000 

看 到 的 Spring Boot Admin 图 形 化 监控 界面 中 ， 就 能 在 无 须 进行 安全 验证 的 情况 下 看 到 该 项 目的 运 
行 状 态 。 
步骤 03 编写 客户 端的 启动 类 ， 代 码 如 下 。 

// 省 略 必 要 的 Package 和 import 代码 

@SpringBootApplication 

public class ClientApp{ 

public static void main( String[] args ){ 


SpringApplication.run(ClientApp.class, args); 
} 


oAGDNpp 


aowmwewn 


} 


从 上 述 代码 的 第 2 行 注解 中 ， 我 们 能 看 到 该 客户 端 其 实 是 一 个 Spring Boot 的 应 用 程序 。 在 其 
中 , 我 们 可 以 通过 @Controller 等 的 注解 定义 对 外 的 服务 , 但 这 里 我 们 是 为 了 演示 Spring Boot Admin 
的 监控 效果 ， 所 以 仅 给 出 一 个 启动 类 。 

启动 SpringCloudAdminDemo 和 SpringCloudAdminClient 两 个 项 目 后 ， 再 次 在 浏览 器 中 输入 
localhost:9000, 此 时 我 们 就 能 看 到 针对 SpringCloudAdminClient 微服 务 的 监控 效果 , 如 图 10.2 所 示 。 


B35 :ounhA 


Spring Boot applications 


+ J un vercion info status 


up 


ES 日 


3 


10.2 包含 监控 效果 的 Spring Cloud Admin 效果 图 
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从 图 10.2 中 ,我 们 能 够 看 到 SpringCloudAdminClient 服务 处 于 “UP”( 可 用 ) 状 态 , 单 击 “Details” 
按钮 ,还 能 监控 到 该 项 目 详细 的 运行 期 参数 ， 比 如 内 存 使 用 量 和 在 虚拟 机 中 运行 的 类 的 数量 等 ， 如 
图 10.3 所 示 。 


CR 


Application 
Diskspace 
Free 60.16 
Threshold 10M 
JVM 
Memory (50.1M / 56.4M) Uptime 00:00:04:25 [d:h:m:s] 
Systemload -1.00 (last min. » runq-sz) 
Heap Memory (25.3M / 31.6M) 
Available Processors 2 
Initial Heap 16M Classes current loaded 6809 


10.3 通过 Spring Boot Admin 监控 到 的 详细 信息 


其 实 , 通过 Actuator 接口 , 我 们 还 能 看 到 如 图 10.3 所 示 的 各 项 运行 期 指标 , 但 就 没 Spring Boot 
Admin 直观 和 方便 了 。 


10.1.2 与 Eureka 的 整合 


从 上 文中 我 们 能 看 到 ， 为 了 能 让 Spring Boot Admin 服务 端 监控 到 ， 我 们 需要 把 待 监控 的 项 目 
设置 成 Spring Cloud Admin 的 客户 端 。 

事实 上 ， 在 大 多 数 实际 项 目 中 ， 我 们 是 通过 Eureka 来 管理 各 微服 务 组 件 的 。 在 这 类 场景 中 ， 
我 们 只 需要 把 Spring Cloud Admin 服务 端 和 Eureka 服务 端 关 联 上 ， 注 册 到 该 Eureka 服务 器 的 所 有 
微服 务 即 可 自动 地 被 Spring Boot Admin 服务 器 监控 ， 而 且 该 Eureka 服务 端 也 能 被 监控 。 

本 小 节 的 案例 将 包含 如 下 三 个 项 目 ， 其 中 ，EurekaServerAdmin 是 Spring Cloud Admin 的 服务 
端 ， 它 将 和 EurekaServerWithAdmin 这 个 Eureka 服务 器 相关 联 ， 而 EurekaClientWithAdmin 则 是 注 
册 到 Eureka 服务 器 的 Eureka 客户 端 。 


代码 位 置 视频 位 置 
代码 \ 第 10 章 \EurekaServerAdmin 
代码 \ 第 10 章 \EurekaServerWithAdmin 视频 \ 第 10 章 \Spring Boot Admin 与 Eureka 的 整合 


代码 \ 第 10 章 \EurekaClientWithAdmin 
1. 搭建 Spring Cloud Admin 服务 端 
我 们 可 以 通过 如 下 关键 步骤 搭建 Spring Cloud Admin 的 服务 端 。 
步骤 014 在 pom.xml 中 引入 Eureka 和 Spring Cloud Admin 的 依赖 包 ， 关 键 代码 如 下 。 
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元 <dependency> 

2 <groupId>org.springframework.cloud</groupId> 

2 <artifactId>spring-cloud-starter-eureka</artifactId> 
4 </dependency> 

5 <dependency> 

6 <groupId>de.codecentric</groupId> 

7 <artifactId>spring-boot-admin-server</artifactId> 

8 <version>1.5.7</version> 

9 </dependency> 

10 <dependency> 

和 <groupId>de.codecentric</groupId> 

be <artifactId>spring-boot-admin-server-ui</artifactId> 
3 <version>1.5.7</version> 

14 </dependency> 


在 上 述 代 码 的 第 10~13 行 中 ， 我 们 还 引入 了 关于 Admin 界面 的 依赖 包 ， 这 样 我 们 就 可 以 通过 
Web 页 面 看 到 监控 的 效果 。 

步骤 024 在 application.yml 文件 中 指定 该 项 目的 服务 端口 , 并 
服务 器 上 ， 相 关 代码 如 下 。 


server: 
port: 9000 
spring: 
application: 
name: admin-server 
eureka: 
client: 
serviceUrl: 
defaultZone: http://localhost:8888/eureka/ 
10 management: 
JU Security: 
12 enabled: false 


指定 该 项 目 需要 关联 到 Eureka 


ownamumewnP 


其 中 ， 通 过 第 2 行 代 码 指定 了 该 项 目 工作 在 9000 端口 ， 通 过 第 9 行 代码 指定 了 该 项 目 会 注册 
到 http://localhost:8888/eureka/ 这 个 Eureka 的 服务 器 上 。 


步骤 034 编写 启动 类 AdminServerAppjava ， 关 键 代 码 如 下 。 通 过 第 3 行 的 
@EnableAdminServer 注解 ， 我 们 指定 了 该 项 目 承 担 着 Spring Cloud Admin 服务 器 的 角色 。 


// 省 略 必要 的 package 和 import 代码 

@EnableAutoConfiguration 

@EnableAdminServer 

public class AdminServerApp { 
Public static void main( String[] args ) { 
SpringApplication.run (AdminServerApp.class, args); 
上 


o vawmwwm 


} 
2. 搭建 Eureka 服务 端 


第 1 部 分 构建 的 Spring Cloud Admin 服务 端 是 向 这 里 搭建 的 Eureka 服务 端 注册 的 ， 这 部 分 代 
码 的 关键 点 如 下 。 
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关键 点 1: 在 pom.xml 中 引入 Eureka 服务 器 的 依赖 包 ， 关 键 代码 如 下 。 


a <dependency> 

4 <groupId>org.springframework.cloud</groupId> 

3 <artifactId>spring-cloud-starter-eureka-server</artifactId> 
4 </dependency> 


关键 点 2: 在 application.yml 中 设置 针对 Eureka 服务 器 端的 配置 ， 代 码 如 下 。 


SerVer: 
port: 8888 
spring: 
application: 
name: eurekaServer 
eureka: 
client: 
serviceUrl: 
9 defaultZone: http://localhost:8888/eureka/ 
10 management: 
hi security: 
12 enabled: false 


从 第 2 行 代码 中 ， 我 们 能 看 到 该 服务 是 运行 在 8888 端口 上 的 ; 通过 第 9 行 代 码 ， 我 们 能 看 到 
该 Eureka 服务 器 的 注册 路 径 url。 在 第 1 部 分 中 ，Spring Cloud Admin 也 是 向 这 个 路 径 注册 的 。 

关键 点 3: 编写 启动 类 ServerApp.java， 这 部 分 知识 点 我 们 在 讲解 Eureka 的 时 候 讲 过 ， 所 以 这 
里 只 给 出 代码 ， 不 做 讲解 。 


oamwmwewmP 


给 
1  Q@SpringBootApplication 
2  Q@EnableEurekaServer 
3 public class ServerApp { 
4 public static void main(String[] args) { 
3 SpringApplication.run(ServerApp.class, args); 
6 } 
eh 
在 上 述 Eureka 服务 器 的 代码 中 ， 我 们 没 看 到 任何 与 Spring Cloud Admin 相关 联 的 代码 。 事 实 
上 ， 我 们 在 整合 Spring Cloud Admin 和 Eureka 时 ， 只 需要 把 Spring Cloud Admin 端 注册 到 Eureka 
服务 端 接口 。 


3. 引入 Eureka 客户 端 


在 这 部 分 的 EurekaClientWithAdmin 项 目 中 ， 我 们 将 提供 一 个 输出 “hello”+ 用 户 名 的 方法 。 
这 部 分 代码 和 之 前 Eureka 部 分 的 代码 很 相似 ， 所 以 请 大 家 在 本 书 附带 的 代码 中 自行 阅读 ， 这 里 就 
不 给 出 详细 的 代码 了 。 但 请 大 家 注意 ,在 Eureka 客户 端 , 我 们 同样 没有 引入 和 Spring Cloud Admin 
相关 的 代码 。 

4. 查看 运行 结果 

由 于 Spring Cloud Admin 是 注册 到 Eureka 服务 端的 ， 因 此 这 里 请 大 家 先 启动 Eureka 服务 端 
EurekaServerWithAdmin， 在 此 基础 上 再 启动 Spring Cloud Admin 服务 端 EurekaServerAdmin 和 
Eureka 客户 端 EurekaClientWithAdmin。 

启动 完成 后 ， 在 浏览 器 中 输入 “http://localhost:9000/”， 我 们 能 看 到 通过 Spring Cloud Admin 
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监控 的 所 有 微服 务 ， 如 图 10.4 所 示 。 


SAYHELLO (5be1b7ff) DOWN 


ADMIN-SERVER (42e393e6) 


EUREKA (950e08dd) UP 


图 10.4 Spring Cloud Admin 与 Eureka 整合 后 的 监控 效果 图 


虽然 在 Eureka 的 服务 端 和 客户 端 我 们 都 没 加 入 与 Spring Cloud Admin 相关 的 代码 ,但 在 图 10.4 
中 ， 我 们 还 是 能 看 到 上 述 两 个 微服 务 被 监控 的 效果 ， 同 样 ， 单 击 右边 的 “Details” 按 钮 ， 我 们 还 能 
看 到 关于 该 微服 务 的 详细 信息 。 

事实 上 ， 在 这 个 演示 案例 中 ， 我 们 只 向 Eureka 服务 端 注 册 了 一 个 服务 ， 如 果 我 们 注册 多 个 服 
务 ， 那 么 这 些 被 注册 的 服务 同样 会 被 Spring Cloud Admin 监控 到 。 


10.1.3 ”设置 报警 邮件 


前 面 我 们 实现 了 基于 Spring Cloud Admin 图 形 化 监控 的 效果 .。 但 作为 系统 维护 人 员 , 不 可 能 一 
直 盯 着 屏幕 ， 最 好 是 当 待 监控 的 微服 务 宠 机 时 ， 能 收 到 报警 邮件 。 下 面 我 们 来 讲 相关 的 实现 方法 。 

第 一 步 ， 在 Spring Cloud Admin 的 服务 器 端 〈 即 EurekaServerAdmin 项 目的 pom.xml 中 ) 添加 
关于 邮件 的 依赖 包 ， 关 键 代码 如 下 。 

1 <dependency> 

<groupId>org.springframework.boot</groupId> 

3 <artifactId>spring-boot-starter-mail</artifactId> 

4 <version>1.5.9.RELEASE</version> 

5 </dependency> 

第 二 步 ， 还 是 在 Spring Cloud Admin 的 服务 器 端 ， 在 application.yml 配置 文件 中 增加 和 报警 邮 
件 相关 的 设置 ， 相 关 代码 如 下 。 


spring: 

2 mail: 

3 host: smtp.163.com 

4 username: hsm computer # change to your username 
5 Password: change to your pwd 
6 properties: 

| mail: 

8 smtp: 

9 auth: true 

10 starttls: 

LL enable: true 

了 人 required: true 


13 boot: 
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14 admin: 

1 notify 

16 mail 

17 from: hsm computer@163.com 
18 to: hsm computer@163.com 


其 中 ， 在 第 3~5 行 设置 了 邮件 发 送 者 的 主机 、 用 户 名 和 密码 ， 这 里 作者 给 出 了 用 户 名 ， 隐 去 
了 密码 ,大 家 在 实践 时 需要 做 相应 的 改动 .而 在 第 17 行 和 第 18 行 中 设置 了 邮件 的 发 送 方 和 接收 方 。 
编写 完成 并 重启 相关 的 服务 后 ， 大 家 可 以 故意 下 线 待 监控 的 服务 〈 比 如 Eureka 服务 端 ) ， 这 
时 就 能 看 到 如 图 10.5 所 示 的 警告 邮件 。 
EUREKA (950e08dd) is OFFLINE 上 = 


我 <hsm_computer@163.com 


我 <hsm_computer@163.com 


这 个 0 系统 己 打通 微 信 、 钉 条。 免费 试用 > 


wm ji 


EUREKA (950e08dd) 
status changed from UP to OFFLINE 


http://192. 168. 42. 1:8888/health 


图 10.5 报警 邮件 的 效果 图 


10.2 ”通过 Sleuth 组 件 跟踪 服务 调用 链 路 


在 Spring Cloud 组 件 体系 中 ，Sleuth 组 件 提供 了 针对 服务 跟踪 的 解决 方案 。 通 过 该 组 件 ， 我 们 
能 够 看 到 服务 调用 链 路 的 相关 日 志 ， 从 而 能 在 问题 发 生 时 快速 地 定位 到 问题 点 。 

不 过 ，Sleuth 一 般 是 向 控制 台 ( 或 文件 等 其 他 介质 ) 输入 日 志 信 息 ， 由 于 在 微服 务 系统 中 ,日 
志 信 息 量 很 大 ， 因 此 在 实际 应 用 中 ， 我 们 往往 会 把 Sleuth 与 数据 分 析 组 件 〈 如 Zipkin) 整合 使 用 ， 
以 求 更 高 效 地 排查 问题 。 


10.2.1 ”基于 Sleuth 案例 的 总 体 说 明 


本 小 节 是 根据 第 3 章 中 的 Eureka 的 相关 案例 改编 而 成 的 。 


代码 位 置 视频 位 置 

代码 \ 第 10 章 \EurekaServerForSleuth 

代码 \ 第 10 章 \EurekaServiceProviderForSleuth 视频 \ 第 10 章 \Sleuth 案例 说 明 
代码 \ 第 10 章 \EurekaServiceCallerForSleuth 


其 中 ，EurekaServerForSleuth 承担 着 Eureka 服务 器 的 角色 ， 它 是 根据 EurekaBasicDemo-Server 
改编 而 成 的 ， 除 了 项 目 名 之 外 ， 其 他 没有 改变 。 特 别 是 ， 在 这 个 项 目 中 没有 引入 Sleuth 组 件 。 
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10.2.2 ”关于 服务 提供 者 案例 的 说 明 


EurekaServiceProviderForSleuth 项 目 是 根据 EurekaBasicDemo-ServiceProvider 改编 而 成 的 ， 它 
有 如 下 改动 点 。 
改动 点 1: 在 pom.xml 中 引入 了 针对 Sleuth 组 件 的 依赖 包 ， 关 键 代码 如 下 。 


时! <parent> 

加 <groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-parent</artifactId> 
4 <version>1.3.8.RELEASE</version> 
5 <relativePath/> 
6 </parent> 

7 <dependencies> 

8 // 省 略 其 他 关于 Spring cloud 等 的 依赖 包 

9 <dependency> 

10 <groupId>org.springframework.cloud</groupId> 

了 <artifactId>spring-cloud-starter-sleuth</artifactId> 
入 </dependency> 

03 </dependencies> 


其 中 ， 在 第 1~6 行 代码 中 定义 了 spring-boot-starter-parent 父 级 依赖 包 的 版 本 号 是 
1.3.8.RELEASE， 在 第 9~12 行 代码 中 引入 了 sleuth 依赖 包 。 
改动 点 2: 在 服务 的 控制 器 类 中 增加 了 Logger 的 打印 语句 ， 相 关 代码 如 下 。 


1 ，“// 省 略 必要 的 package 和 import 的 代码 

2 @RestController 

3 public class Controller { 

4 ”// 定 义 logger 打印 类 

5 Private final Logger logger = Logger.getLogger (getClass()); 

6 @RequestMapping (value = "/hello/{username}", method = 
RequestMethod.GET ) 

有 public String hello(@PathVariable("username") String username) { 

8 logger.info("Starting provide hello function."); 

9 return "hello " + username; 

10 1 

i1. 省 


在 第 7 行 的 hello 方法 中 ， 我 们 在 第 8 行 中 输出 了 一 段 话 ， 运 行 时 ， 我 们 能 从 中 看 到 Sleuth 组 
件 的 痕迹 。 


10.2.3 ”关于 服务 调用 者 案例 的 说 明 


EurekaServiceCallerForSleuth 是 根据 EurekaBasicDemo-ServiceCaller 项 目 改编 而 成 的 ， 我 们 需 
要 在 它 的 pom.xml 文件 中 引入 Sleuth 依赖 包 , 该 项 目的 pom.xml 和 EurekaServiceProviderForSleuth 
很 类 似 ， 只 是 改 了 项 目 名 ， 所 以 就 不 再 详细 分 析 了 ， 大 家 可 以 在 本 书 附带 的 代码 中 看 到 详细 内 容 。 

同样 ， 我 们 改写 了 控制 器 类 中 的 服务 调用 的 代码 ， 在 其 中 也 加 入 了 Logger 的 打印 语句 ， 相 关 
代码 如 下 。 
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1 “// 省 略 必 要 的 package 和 import 代码 

2 @RestController 

3  Q@Configuration 

4 public class Controller { 

5 ”// 定 义 打印 类 

6 Private final Logger logger = Logger.getLogger (getClass()); 

7 @Bean 

8 @LoadBalanced public RestTemplate getRestTemplate(){ 

9 return new RestTemplate(); 

LO} 

i @RequestMapping (value = "/hello", method = RequestMethod.GET ) 

2 public String hello() { 

13 logger.info("Starting caller hello function."); 

14 RestTemplate template = getRestTemplate(); 

15 String retVal = template.getForEntity("http://sayHello/ 
hello/Eureka", String.class) .getBody(); 

16 return "In Caller, " + retVal; 

} 

8 


在 第 12 行 的 hello 方法 中 ， 我 们 在 第 13 行 通过 logger.info 输出 了 一 段 话 。 请 注意 ， 我 们 同样 
能 在 这 里 看 到 Sleuth 的 效果 。 


10.2.4 ”通过 运行 效果 了 解 Sleuth 组 件 


在 上 文中 ， 我 们 只 给 出 了 三 个 项 目 和 第 3 章 项 目的 差别 ， 本 书 的 附带 代码 中 给 出 了 上 述 三 个 
项 目的 完整 代码 。 上 述 三 个 项 目的 调用 关系 是 ，EurekaServiceCallerForSleuth 项 目 中 的 hello 方法 会 
调用 EurekaServiceProviderForSleuth 项 目 中 的 同名 方法 。 

我 们 依次 启动 上 述 三 个 项 目 ， 并 在 浏览 器 中 输入 “http://localhost:8080/hello ”， 将 会 触发 
EurekaServiceCallerForSleuth 项 目 中 的 hello 方法 。 

在 EurekaServiceCallerForSleuth 项 目的 控制 台中 ， 我 们 能 看 到 如 下 输出 。 


1 2018-09-24 21:36:23.048 INFO 

2 [callHello,eab79ef226db8d44,a3480472ff85c2b2, false] 17480 --- 
a [nio-8080-exec-8] troller$$EnhancerBySpringCGLIB$$64a08723 : 
4 Starting caller hello function. 


上 述 输出 其 实 是 在 一 行 里 的 ， 我 们 只 是 为 了 分 析 方便 ， 所 以 把 它 分 成 4 行 。 

在 第 2 行 的 方 括号 中 , 有 4 个 参数 , 其 中 第 一 个 参数 是 项 目 名 , 这 和 我 们 定义 在 application.yml 
中 的 spring.application.name 值 一 致 ， 第 二 个 参数 是 Sleuth 提供 的 TraceID， 即 链 路 名 ; 第 三 个 参数 
是 Sleuth 提供 的 SpanID， 表 示 调 用 名 ; 第 四 个 参数 表示 该 句 日 志 是 否 会 被 Zipkin 等 服务 收集 并 分 
析 ， 这 里 是 false。 至 于 其 他 几 行 输出 的 日 志 ， 和 Sleuth 组 件 无 关 。 

我 们 再 来 看 EurekaServiceProviderForSleuth 项 目 控制 台中 的 相关 日 志 ， 同样 , 它 也 是 输出 在 一 
行 中 的 ， 为 了 讲解 方便 ， 我 们 把 它 分 成 了 4 行 。 

号 2018-09-24 21:36:23.048 INFO 

[sayHello,eab79ef226db8d44,d6fe73695ab24d85, false] 4376 --- 


2 
- [nio-1111-exec-5] com.controller.Controller : Starting 
4 provide hello function. 
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我 们 能 够 看 到 , 第 2 行 中 第 2 个 参数 ( 即 TraceID ) 和 EurekaServiceCallerForSleuth 中 的 一 致 ， 
说 明 这 两 个 输出 语句 所 在 的 方法 是 处 在 同一 个 调用 链 路 上 的 , 这 非常 符合 我 们 事先 了 解 到 的 调用 链 
路 关系 , 即 EurekaServiceCallerForSleuth 的 hello 方法 会 调用 EurekaServiceProviderForSleuth 项 目 中 
的 同名 方法 。 


10.2.5 通过 Sleuth 组 件 分 析 问 题 的 一 般 方 法 


上 述 案 例 给 出 了 Sleuth 组 件 输出 的 一 般 形式 ， 在 实际 的 项 目 中 ， 通 过 Sleuth 组 件 ， 我 们 一 般 
会 采用 如 下 步骤 来 分 析 问 题 。 


第 一 ， 根 据 第 二 个 参数 TraceID， 我 们 能 找到 同一 条 调用 链 路 。 

第 二 ， 根 据 输出 时 间 的 先后 ， 我 们 能 列 出 同一 条 调用 链 路 中 的 先后 调用 关系 。 

第 三 ， 根 据 logger 输出 的 提示 ， 我 们 能 看 到 每 个 调用 链 路 节点 上 的 关键 信息 。 

根据 上 述 三 步 ， 我 们 一 般 就 可 以 排查 出 具体 的 问题 。 但 在 实际 项 目 中 ， 输 出 的 日 志 非常 多 ， 
如 果 用 人 工 的 方式 来 排查 ， 效 率 就 会 很 低 ， 而 且 工作 量 很 大 。 为 了 提升 性 能 ， 我 们 一 般 会 把 Sleuth 
组 件 整合 Zipkin 等 数据 收集 和 展示 组 件 。 


10.3 ”整合 Zipkin 查询 和 分 析 日 志 


Zipkin 是 一 个 开源 的 分 布 式 实时 数据 追踪 组 件 ， 它 可 以 用 来 收集 来 自 各 异 构 系 统 的 监控 数据 ， 
并 以 图 表 的 方式 向 用 户 展示 ， 以 便 用 户 从 整个 调用 链 路 的 角度 排查 和 分 析 分 布 式 系统 中 的 问题 。 
这 里 ， 我 们 将 把 Sleuth 日 志 发 送 给 Zipkin， 并 通过 Zipkin 界面 查看 整个 基于 微服 务 的 调用 链 


10.3.1 搭建 Zipkin 服务 器 


代码 \ 第 10 章 \SleuthZipkinServer 视频 \ 第 10 章 \ 拱 建 Zipkin 服务 


在 基于 Maven 的 SleuthZipkinServer 项 目 中 ， 我 们 将 按 如 下 步骤 搭建 Zipkin 服务 器 。 
步骤 014 在 pom.xml 中 引入 Zipkin 服务 器 组 件 和 Zipkin 图 形 界面 组 件 的 依赖 包 ， 关 键 代 码 
如 下 。 其 中 ， 通 过 前 4 行 代码 引入 Zipkin 服务 器 组 件 的 依赖 包 ， 通 过 后 4 行 代码 引入 Zipkin 图 形 
界面 组 件 的 依赖 包 。 


和 <dependency> 

之 <groupId>io.zipkin.java</groupId> 

3 <artifactId>zipkin-server</artifactId> 
4 </dependency> 

3 <dependency> 

6 <groupId>io.zipkin.java</groupId> 
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了 <artifactId>zipkin-autoconfigure-ui</artifactId> 
8 </dependency> 


步 又 024 编写 Zipkin 服务 器 的 启动 类 ZipkinServerAppjava， 代 码 如 下 。 


Springapplication.run(ZipkinServerRpp.class，args) 7 
} 


1 // 省 略 必要 的 package 和 import 代码 

之 QSpringBootRAPP1ication 

3  Q@EnableZzipkinServer 

4 public class ZipkinServerApp { 

5 public static void main( String[] args ) { 
6 

了 

8 


} 
在 第 3 行 中 ， 我 们 通过 引入 @EnableZipkinServer 注解 来 说 明 该 启动 类 是 Zipkin 服务 器 。 
步骤 034 在 application.yml 中 指定 该 项 目的 配置 信息 ， 代 码 如 下 。 


server: 
Port: 9411 
spring: 
application: 
name: SleuthZzipkinServer 


MAODP 


其 中 ， 通 过 前 两 行 代码 定义 了 Zipkin 服务 器 的 工作 端口 是 9411， 通 过 第 3~5 行 代码 定义 了 该 
项 目的 名 字 。 

完成 上 述 步骤 后 ， 我 们 可 以 通过 ZipkinServerApp.java 启动 Zipkin 服务 器 。 启 动 完 成 后 ， 如 果 
在 浏览 器 中 输入 “http:Wlocalhost:9411”， 就 能 看 到 如 图 10.6 所 示 的 Zipkin 界面 。 


callhello "al 7 Starttime 09-29-201 17:14 


End time 10- 17:14 Duration (hs) >= Limit 10 FindTraces © 


Please select the criteria for your trace lookup. 


图 10.6 ”Zipkin 界面 效果 图 


10.3.2 ”从 Zipkin 图 表 上 查看 Sleuth 发 来 的 日 志 


这 里 ， 我 们 将 改写 10.2 节 的 EurekaServiceProviderForSleuth 和 EurekaServiceCallerForSleuth， 
把 这 两 个 项 目 中 Sleuth 收集 到 的 日 志 信息 发 送 给 Zipkin。 具 体 的 修改 点 如 下 。 
修改 点 1: 在 这 两 个 项 目的 pom.xml 文件 中 添加 针对 sleuth 整合 zipkin 的 依赖 包 ， 关键 代码 如 下 。 
<dependency> 
<groupId>org.springframework.cloud</groupId> 


<artifactId>spring-cloud-sleuth-zipkin</artifactId> 
</dependency> 


心 w N 
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修改 点 2: 在 这 两 个 项 目的 application.yml 文件 中 添加 如 下 代码 ， 以 实现 两 个 目的 。 
bb spring: 

2 zipkin: 

3 base-url: http://localhost:9411 

4 sleuth: 

5 sampler: 

6 percentage: 1 


通过 第 1~3 行 代码 ， 我 们 指定 了 在 这 两 个 项 目 中 ， 把 基于 Sleuth 的 日 志 发 送 到 前 文 定义 好 的 
Zipkin 服务 器 的 路 径 上 。 通 过 第 4~6 行 代码 ， 我 们 指定 了 把 100% 的 日 志 〈 即 所 有 的 日 志 ) 发 送 到 
Zipkin 服务 端 。 

我 们 以 之 前 分 析 过 的 基于 Sleuth 的 日 志 为 例 ， 在 第 4 行 中 ， 第 4 个 参数 表示 该 日 志 是 否 会 被 
Zipkin 收集 。 

下 2018-09-24 21:36:23.048 INFO 

2 [callHello,eab79ef226db8d44,a3480472ff85c2b2, false] 17480 --- 

3 [nio-8080-exec-8] troller$$EnhancerBySpringCGLIB$$64a08723 : 

4 Starting caller hello function. 

这 里 涉及 一 个 “抽样 率 ”， 我 们 可 以 通过 sleuth.sampler.percentage 定义 抽样 率 ， 默 认 是 10%， 
即 0.1。 这 里 我 们 为 了 演示 方便 , 定义 了 抽样 率 是 100%， 也 就 是 说 所 有 的 日 志 都 会 被 发 送 到 Zipkin 
服务 器 端 。 

完成 上 述 改动 后 ， 我 们 依次 启动 SleuthZipkinServer (Zipkin 服务 器 端 项 目 ) 和 10.2 节 定义 的 
EurekaServerForSleuth、EurekaServiceProviderForSleuth 和 EurekaServiceCallerForSleuth 三 个 项 目 ， 
随后 在 浏览 器 中 输入 “http://localhost:8080/hello”， 再 来 访问 服务 。 

此 时 ， 由 于 我 们 设置 了 100% 的 抽样 率 ， 因 此 在 EurekaServiceCallerForSleuth 项 目的 控制 台中 
能 看 到 相关 的 参数 是 true， 如 图 10.7 所 示 。 


图 10.7 设置 100% 抽 样 率 后 相关 参数 始终 是 tue 


我 们 再 到 http://localhost:9411 页 面 ， 在 输入 查询 条 件 后 ， 单 击 “Find Traces” 按 钮 ， 即 可 看 到 
如 图 10.8 所 示 的 效果 图 。 


Find a trace 


callhello 时 all ™ Starttime 10-06-2018 16.:41 

End time 10-06-2018 1741 Duration (ps) >= Limit 10 FindTraces | © 
Showing: 1of1 Sort: [Longest First 
sevces ET 


31.000ms 5 spans 
callhello 174% 


ET ET 


图 10.8 在 Zipkin 界面 中 看 到 的 服务 调用 效果 图 
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如 果 再 具体 到 某 个 实例 ， 还 能 看 到 如 图 10.9 所 示 的 详细 信息 。 


Duration: @NITY services: Depth:@ Totalspans: ©O 
Expand AI | Collapse A | Filler 


-Er tooms wpeloleue 


2581ms: helo 


10.9 调用 关系 的 详细 信息 


在 其 中 ， 我 们 能 看 到 某 个 调用 步骤 的 耗 时 信息 ， 如 果 调 用 出 问题 的 话 ， 我 们 还 能 看 到 问题 出 
在 哪个 环节 。 


10.3.3 在 MySQL 中 保存 Zipkin 数据 


当 项 目 在 测试 阶段 时 ， 我 们 可 以 如 10.3.2 小 节 那 样 ， 把 抽样 率 设置 成 100%， 然 后 通过 观察 
Zipkin 数据 来 监控 、 分 析 或 定位 问题 。 

当 一 个 项 目 上 线 并 已 经 运行 稳定 时 ， 出 于 节省 资源 的 考虑 ， 我 们 可 以 把 抽样 率 设置 得 小 一 些 ， 
比如 采用 默认 的 10% 比 例 。 并 且 ， 我 们 也 无 须 实时 监控 ， 所 以 可 以 通过 如 下 步骤 把 Zipkin 中 的 数 
据 保存 到 MySQL 数据 库 中 ， 一 旦 有 问题 ， 就 可 以 从 MySQL 中 调 取 出 抽样 的 监控 数据 来 分 析 。 

步骤 014 在 MySQL 的 数据 库 中 创建 一 个 名 为 zipkin 的 Schema ( 即 数据 库 )， 在 其 中 ， 无 须 
建 表 。 

步骤 024 在 SleuthZipkinServer 项 目 ( Zipkin 服务 端 项 目 ) 的 pom.xml 中 引入 和 数据 库 以 及 
JDBC 等 关联 的 依赖 包 ， 关 键 代 码 如 下 。 


1 <dependency> 

2 <groupId>io.zipkin.java</groupId> 

3 <artifactId>zipkin-autoconfigure-storage-mysql</artifactId> 
4 </dependency> 

5 <dependency> 

6 <groupId>mysql</groupId> 

gy <artifactId>mysql-connector-java</artifactId> 

8 </dependency> 

9 <dependency> 

10 <groupId>org.springframework.boot</groupId> 

i <artifactId>spring-boot-starter-jdbc</artifactId> 
12 </dependency> 


通过 第 1~4 行 代码 引 入 了 Zipkin 整合 MySQL 的 依赖 包 ， 这 样 当 我 们 第 一 次 启动 Zipkin 服务 
器 时 ， 会 从 中 读 取 到 创建 MySQL 表 的 脚本 。 

通过 第 5~8 行 代码 引入 了 MySQL 的 依赖 包 。 如 果 不 引 入 第 9~12 行 的 依赖 包 , 那么 在 启动 时 ， 
虽然 可 以 读 取 到 创建 Zipkin 表 的 脚本 ,但 是 无 法 建 表 ， 相 应 的 ， 也 就 无 法 把 Zipkin 的 相关 数据 写 
入 MySQL 表 中 了 。 
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步骤 034 在 SleuthZipkinServer 项 目的 application.yml 文件 中 , 编写 Zipkin 整合 MySQL 的 相 
关 参 数 ， 关 键 代码 如 下 。 


spring: 
datasource: 
schema: classpath:/mysql.sql 
url: jdbc:mysql://localhost:3306/zipkin 
username: root 
password: 和 你 MysQL 的 密码 一 致 
continueOnError: true 
initialize: true 
zipkin: 
storage: 
type: mysql 


PPioowamwmcwnP 


0 
1 

其 中 ， 在 第 3 行 中 指定 了 相关 建 表 和 插入 表 的 SQL 语句 ， 这 些 语 句 是 包含 在 依赖 包 中 的 。 在 
第 4-~6 行 中 ， 我 们 指定 了 连接 MySQL 表 的 相关 参数 。 在 第 11 行 代码 中 ， 我 们 指定 了 Zipkin 的 保 
存 方式 是 mysql。 

完成 上 述 修改 后 ， 启 动 Zipkin 服务 器 ， 我 们 就 能 在 Zipkin 数据 库 中 看 到 zipkin_annotations 和 
zipkin_spans 两 张 表 。 

再 启动 EurekaServerForSleuth、EurekaServiceProviderForSleuth 和 EurekaServiceCallerForSleuth 
三 个 项 目 ， 在 浏览 器 中 输入 “http://localhost:8080/hello”， 则 能 在 刚才 提 到 的 两 张 表 中 看 到 数据 ， 
其 中 ，zipkin_spans 表 中 的 数据 如 图 10.10 所 示 。 


name parent_id debug start_ts dur ation 
hello ;1586909945274 3832136968000 57300 
3286177693796 J945274 http: Ahe-.8604278958719 3832136937000 97206 
j286177693796 1945274 http:/he:.8604278958719 3832136078000 1015000 
J286177693796 ;958719 hello "9286177693796 3832135984000 1132942 
J286177693796 "893796 http:/he: 3832135828000 1285587 


图 10.10 ”zipkin_spans 表 中 的 数据 效果 图 


从 图 10.10 中 ， 我 们 能 看 到 标识 调用 链 路 的 trace_id 以 及 调用 时 间 等 信息 ， 由 此 我 们 能 看 到 整 
个 调用 链 路 的 情况 。 
而 zipkin_annotations 表 的 数据 如 图 10.11 所 示 ， 其 中 还 包含 服务 名 、 调 用 端口 等 信息 。 


spanid akey avalue atype atinestap endpointipr4 endpoint.port endpoint_service nane 
6 1926318995616736791 le (BLOB) 6 .538832136968000 -1062721023 1111 sayhello 
N2881 1926318995816736791 mve. contr, (BLDB) 6 .538832136968000 -1062721023 1111 sayhello 
-5555779288177693796 1926318995816736791 nve. contr, (BLOB) 6 .538832136968000 -1062721023 1111 sayhello 
-5555779288177693796 -6332881588909945274 sr -1 .538832136937000 -1082721023 1111 sayhello 


-5555779288177893796 。。 -6332861586909945274 ss -1 ,538832137031000 -1062721023 1111 sayhello 
-5555779286177693796 -6332861586909945274 cs -1 .538832138078000 -1062721023 B080 callhello 
-5555779286177693796 -6332861586909945274 er -1 .538832137093000 -1062721023 B080 callhello 
-5555779286177693796 © -63328615869099452T4 http.host (BLOB) 6 .538832136078000 -1062721023 8080 callhello 
-5555779288177893796 -63328615869099452T4 http. neth, (BLOB) 6 538832138078000 -1082721023 S080 callhello 


10.11 ”zipkin_annotations 表 中 的 数据 效果 图 
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10.3.4 ”如何 根 据 Zipkin 结果 观察 调用 链 路 


根据 Sleuth 发 来 的 日 志 信息 ，Zipkin 组 件 能 计算 出 关于 调用 链 路 的 明细 信息 ， 比 如 某 个 调用 
所 耗费 的 时 间 。 在 10.3.2 小 节 ， 这 些 信 息 是 以 图 形 化 界面 的 形式 展示 的 ， 而 在 10.3.3 小 节 ， 是 以 数 
据 记 录 的 形式 展示 的 。 在 这 些 结果 里 ， 我 们 能 看 到 如 下 关键 要 素 。 


第 一 ，Span 代表 一 次 调用 的 过 程 ， 它 的 相关 数据 是 保存 在 zipkin_spans 表 中 的 。 每 次 当 大 家 
在 浏览 器 中 输入 “http://localhost:8080/hello” 时 ， 都 能 在 该 表 中 看 到 如 图 10.10 所 示 的 结果 。 从 中 
我 们 能 看 到 ，caller 调用 provider 即 是 一 次 调用 ， 由 此 会 产生 一 个 Span 记录 。 

每 条 Span 记录 都 有 它 的 id 和 parend_id( 父 id) ， 从 中 能 看 出 该 次 调用 是 由 哪个 调用 触发 的 ， 
而 且 同 一 条 调用 链 路 的 请 求 会 有 不 同 的 spanid 〈 即 zipkin_spans 表 中 的 id) ， 但 它们 的 trace id 是 
一 样 的 ， 即 通过 trace id， 我 们 能 串联 出 一 条 调用 链 路 上 的 调用 记录 。 

第 二 ，Trace 代表 整个 调用 链 路 ， 用 和 本 章 相关 的 话 来 讲 ，Trace 表示 整个 链 路 的 跟踪 过 程 。 
一 个 Trace 可 以 由 多 个 Span 组 成 ， 从 图 10.9 中 ， 我 们 能 够 看 到 同一 个 Trace 〈 即 同一 个 调用 链 路 
中 不 同 Span 〈 即 调用 过 程 ) 的 树 形 关系 〈 即 逻辑 从 属 关系 ) 。 在 zipkin_spans 表 中 ， 我 们 能 够 根据 
不 同 Span 的 id 和 parent id 看 出 这 些 Span 的 逻辑 从 属 关 系 。 

第 三 ，Annotation 代表 一 个 事件 ， 在 如 图 10.11 所 示 的 zipkin_annotations 表 中 ， 我 们 能 够 看 到 
整个 链 路 调用 过 程 中 的 不 同事 件 信 息 。 

zipkin_annotations 表 中 的 记录 是 由 http://localhost:8080/hello 请 求 触发 而 成 的 ， 其 中 ， 每 条 数 
据 记 录 着 具体 链 路 〈trace) 具体 调用 〈span) 中 的 单个 事件 。 

在 zipkin_annotations 表 的 a_key 字段 中 ,除了 记录 mvc.controller.class 等 和 程序 相关 的 事件 之 
外 ， 还 记录 了 如 表 10.1 所 示 的 Sleuth 中 定义 的 4 个 事件 。 


表 10.1 Sleuth 中 定义 的 4 个 事件 归纳 表 


当 客户 端 发 起 一 个 请 求 时 ， 就 会 触发 该 事件 , 也 就 是 说 , 该 事 
件 代表 着 请 求 开 始 


表示 服务 端 收 到 了 请 求 
srcs 的 时 间 差 则 代表 当 次 请 求 的 延迟 情况 


表示 服务 端 处 理 好 了 这 个 请 求 ,准备 开始 把 处 理 结果 返回 给 客 
Server Send 户 端 

ss-sr 的 时 间 差 则 代表 当 次 服务 的 内 部 处 理 时 间 

表示 客户 端 收 到 了 这 个 请 求 ， 同 时 表示 该 次 调用 结束 

cr-cs 的 时 间 差 则 代表 本 次 请 求 的 总 体 用 时 


在 每 条 zipkin_annotations 记录 中 ， 我 们 不 仅 能 通过 a_key 查看 事件 类 型 ， 而 且 可 以 通过 
a_timestamp 查看 该 事件 的 时 间 戳 。 

从 不 同事 件 的 时 间 差 中 ， 我 们 能 看 到 一 些 问 题 的 线索 。 比 如 同 个 trace_ id、 同 个 span_id 的 sr 
和 cs 之 间 的 时 间 差 过 长 ， 则 说 明 客户 端 和 服务 端 之 间 的 通信 可 能 存在 问题 ， 又 如 ， 相 同 条 件 的 ss 
和 sr 之 间 的 时 间 差 过 长 , 则 说 明 处 理 该 次 调用 的 业务 可 以 优化 (比如 数据 库 调 用 等 部 分 可 以 优化 ) 。 

而 且 ， 从 每 条 记录 的 endpoint_ service_name 字段 中 ， 我 们 能 看 到 当 次 调用 的 服务 名 ， 这 对 我 


Client Send 


Client Received 
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们 排查 问题 大 有 帮助 。 
10.4 本 章 小 结 


在 读 完 本 章 讲述 的 内 容 后 ， 大 家 可 以 了 解 在 微服 务 中 监控 系统 健康 情况 的 一 般 做 法 ， 而 且 ， 
在 此 基础 上 ， 大 家 还 可 以 掌握 通过 Sleuth 整合 Zipkin 有 效 管理 日 志 的 一 般 方法 。 

在 本 章 中 ， 我 们 还 引入 了 日 志 管 理 的 相关 组 件 ， 以 此 实现 了 图 像 化 监控 微服 务 系统 的 效果 。 
在 读 完 本 章 的 内 容 后 , 大 家 可 以 掌握 获取 日 志 、 从 日 志 中 抓 取 相关 内 容 以 及 定位 排查 问题 的 常用 技 
能 ， 这 对 提升 微服 务 系统 的 稳定 性 和 可 靠 性 大 有 帮助 。 


第 11 章 


用 Spring Boot 开发 Web 案例 


在 之 前 的 章节 中 ， 我 们 是 通过 Spring Boot 提供 URL 格式 的 Web 服务 的 ， 此 外 ，Spring Boot 
还 可 以 支持 包含 JSP 或 Spring MVC 等 的 Web 项 目 。 和 传统 的 Spring MVC 开发 模式 相 比 ，Spring 
Boot 能 大 量 减少 XML 配置 信息 ， 从 而 降低 Spring MVC 架构 的 开发 难度 。 

此 外 ,基于 Spring Boot 的 Web 项 目 能 高 效 地 整合 Spring Boot Security 等 组 件 ， 所 以 开发 出 来 
的 Web 应 用 能 比较 便捷 地 实现 安全 方面 的 需求 ， 比 如 身份 验证 和 授权 管理 。 

本 章 将 结合 Spring Boot 开发 Web 项 目的 常用 技能 点 给 出 若干 案例 , 从 中 大 家 不 仅 能 清晰 地 理 
解 Spring Boot 架构 开发 Web 项 目的 常见 做 法 ， 还 能 了 解 Web 程序 与 Eureka 和 Ribbon 等 Spring 
Cloud 常用 组 件 的 整合 方式 。 


11.1 在 Spring Boot 中 整合 JSP 及 MVC 


本 节 将 演示 以 Spring Boot 整合 Web 开发 的 一 般 方式 。 本 节 包 含 的 案例 是 基于 Maven 的 ， 大 
家 不 仅 可 以 了 解 通过 Maven 管理 Web 项 目的 方式 ， 还 可 以 了 解 项 目的 运行 和 部 署 方式 。 


何 引 入 数据 库 组 件 。 


代码 位 置 视频 位 置 
代码 \ 第 11 章 \SpringCloudJspProj 视频 \ 第 11 章 \Spring Boot 中 整合 JSP 


11.1.1 以 Maven 的 形式 创建 Web 项 目 


之 前 我 们 是 用 Maven 的 形式 创建 基于 Java 的 项 目 ， 如 果 要 创建 包含 JSP 的 Java Web 项 目 ， 
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步骤 和 之 前 的 一 致 ， 在 本 项 目 附 带 的 视频 中 ， 大 家 可 以 看 到 详细 的 操作 方法 。 
当 我 们 以 Maven 方式 创建 好 SpringCloudJspProj 项 目 之 后 , 可 以 通过 手动 添加 的 方式 创建 如 表 
11.1 所 示 的 若干 目录 ， 在 其 中 存放 具备 各 自 功能 的 代码 。 


表 11.1 针对 本 项 目 诸多 目录 功能 的 说 明 列 表 


目录 名 功能 说 明 

src/main/java 在 该 目录 中 存放 application.yml 配置 文件 
src/main/java/com 在 其 中 存放 启动 类 

src/main/java/com/controller 在 其 中 存放 控制 器 类 

src/main/java/com/model 在 其 中 存放 User 这 个 Model 类 (模型 业务 类 ) 
src/main/java/com/repository | 在 其 中 存放 JPA 的 数据 库 访问 类 ， 相 当 于 DAO 层 
src/main/java/com/service 在 其 中 存放 Service 层 

src/main/webapp 在 其 中 存放 JSP 等 Web 格式 的 文件 


通过 表 11.1， 我 们 能 够 看 到 ，JSP 等 Web 相关 的 文件 可 以 存放 在 src/main/webapp 目录 中 。 而 
在 该 项 目 中 ， 我 们 是 通过 JPA 的 形式 访问 MySQL 数据 库 的 。 通 过 该 项 目的 pom.xml 文件 ， 我 们 
可 以 引入 JSP 和 JPA 相关 的 依赖 包 ， 关 键 代码 如 下 。 


可 <Parent> 


2 <groupId>org.springframework.boot</groupId> 

2 <artifactId>spring-boot-starter-parent</artifactId> 
4 <version>1.5.4.RELEASE</version> 

二 </parent> 

6 <dependencies> 

<dependency> 

8 <groupId>org.springframework.boot</groupId> 

9 <artifactId>spring-boot-starter-web</artifactId> 
10 </dependency> 

LL <dependency> 

2 <groupId>org.apache.tomcat .embed</groupId> 

和 <artifactId>tomcat-embed-jasper</artifactId> 

14 </dependency> 

15. <dependency> 

16 <groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-devtools</artifactId> 
18 <optional>true</optional> 

19 </dependency> 

20 <dependency> 

2 <groupId>org.springframework.boot</groupId> 

2 <artifactId>spring-boot-starter-data-jpa</artifactId> 
23 </dependency> 

24 <dependency> 

25 <groupId>mysql</groupId> 

26 <artifactId>mysql-connector-java</artifactId> 
27 <version>5.1.3</version> 

28 </dependency> 

29 </dependencies> 


其 中 ， 很 多 依赖 包 之 前 我 们 都 见 过 ， 比 如 通过 第 7~9 行 代码 ， 我 们 引入 了 Spring Boot 的 依赖 
包 ; 通过 第 20~23 行 代 码 ， 我 们 引入 了 JPA 的 依赖 包 ; 通过 第 24~28 行 代码 ， 我 们 引入 了 MySQL 
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的 驱动 包 。 
此 外 ， 由 于 在 这 个 项 目 中 需要 开发 JSP 程序 ， 因 此 我 们 通过 第 11~19 行 代码 引入 了 支持 内 嵌 
Tomcat 的 依赖 包 和 支持 JSP 开发 的 依赖 包 。 


11.1.2 在 Spring Boot 中 引入 JSP (基于 Maven) 


通过 上 述 步 骤 完 成 创建 项 目的 目录 以 及 编写 pom 文件 之 后 ， 我 们 可 以 通过 如 下 步骤 开发 一 个 
简单 的 JSP 运行 案例 。 


步 又 014 在 src/main/java 目录 中 新 建 application.yml 文件 ， 在 其 中 编写 如 下 代码 。 


1 server: 

Port: 8080 

3 spring: 

4 mve: 

人 View: 

6 Prefix: / 

可 suffix: .jsp 


通过 第 2 行 代 码 ， 我 们 指定 了 该 项 目 运行 在 8080 端口 ， 这 个 和 tomcat 的 默认 运行 端口 一 致 。 
通过 第 6 行 和 第 7 行 代码 ， 我 们 指定 了 在 Spring MVC 中 资源 所 需要 添加 的 前 级 和 后 缀 。 
步骤 024 在 src/main/java/com 目录 中 编写 本 项 目的 启动 类 WebServerApp， 代 码 如 下 。 


// 省 略 必 要 的 package 和 import 代码 
@SpringBootApplication 
Public class WebServerApp extends SpringBootServletInitializer { 
Public static void main(String[] args) { 
SpringApplication.run (WebServerApp.class, args); 
} 


aowmwwm 


让 
这 个 类 中 规 中 矩 ， 和 之 前 的 启动 类 没有 太 大 差别 ， 通 过 第 2 行 代码 指定 基于 Spring Boot 的 启 
动 类 。 
步骤 034 在 src/main/java/com/controller 的 目录 中 添加 一 个 名 为 Controller 的 控制 器 类 ， 关 键 
代码 如 下 。 


1 ，“// 省 略 必要 的 Package 和 import 代码 

2 ”@RestController // 通 过 注解 指定 本 类 是 控制 器 类 

3 public class Controller { 

4 @RequestMapping (value = "/index") 

局 Public ModelAndView index() { 

6 ModelAndView modelAndView = new ModelAndView ("welcome"); 
7 modelandView.addobject ("loginName", "Peter"); 

8 return modelAndView; 

9 } 

10 3 


在 这 个 控制 器 类 的 第 4 行 中 , 我 们 通过 @RequestMapping 注解 指定 第 5 行 的 index 方法 可 以 处 
理 /index 格式 的 请 求 。 而 在 index 方法 的 第 6~8 行 代码 中 ， 我 们 通过 ModelAndView 对 象 指定 该 方 
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法 的 返回 方式 。 

具体 而 言 ,在 第 6 行 的 构造 函数 中 指定 了 该 对 象 将 要 跳 转 到 welcome 页 面 ,结合 application.yml 
中 指定 了 前 级 和 后 级 ， 我 们 知道 通过 index 方法 可 以 跳 转 到 /welcomejsp 页 面 ， 再 通过 第 7 行 的 代 
人 码 ， 我 们 使 用 modelAndView 对 象 设置 了 loginName 属性 的 值 是 Peter。 


步骤 04 在 src/main/webapp 目录 中 新 增 名 为 welcome.jsp 的 文件 ， 代 码 如 下 。 


1 <$%@ page language="java" contentType="text/html; charset=UTF-8" 多 > 
2 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> 

3 <html> 

4 <head> 

5 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
6 <title></title> 

7 </head> 

8 <body> 

9 Hello ${loginName}, This is Jsp Page. 

10 </body> 

11 </html> 


关键 代码 在 第 9 行 ， 其 中 将 以 ${loginName} 的 方式 显示 从 控制 器 Controller 类 的 index 方法 中 
传 来 的 loginName 参数 。 

按 上 述 步 骤 完 成 开发 后 ， 启 动 WebServerApp 类 , 并 在 浏览 器 中 输入 “http://localhost:8080/index”， 
此 时 Spring Boot 内 部 会 发 生 如 下 动作 。 

第 一 ， 根 据 控制 器 类 中 的 @RequestMapping 注解 ， 该 请 求 被 index 方法 解析 。 

第 二 ， 根 据 index 方法 中 定义 的 ModelAndView 对 象 ， 以 及 在 application.yml 中 定义 的 前 级 和 
后 级 ， 该 请 求 会 被 携带 着 loginName 等 于 Peter 这 个 值 定位 到 welcome.jsp 页 面 上 。 


所 以 ， 我 们 能 在 浏览 器 中 看 到 welcome.jsp 页 面 ， 有 具体 的 输出 效果 如 下 。 


1 Hello Peter, This is Jsp Page. 


11.1.3 在 Spring Boot 中 引入 MVC 架构 和 数据 库 服 务 


在 上 述 案 例 中 ， 我 们 走 通 了 在 Spring Boot 中 调用 JSP 页 面 的 流程 ， 在 实际 的 项 目 中 ， 一 般 还 
会 引入 Spring MVC 和 数据 库 服务 。 本 小 节 将 在 SpringCloudJspProj 项 目 中 演示 基于 Spring MVC 模 
式 的 案例 ， 其 中 还 将 通过 JPA 来 获得 MySQL 中 的 数据 。 
步骤 014 在 src/main/java/model 类 中 编写 和 数据 库 对 应 表 映 射 的 User 类 ， 相 关 代码 如 下 。 


// 省 略 必 要 的 package 和 import 代码 
@Entity 
@Table (name="User") 
public class User { 
@Id 
Private String ID; 
@Column (name = "Name") 
Private String name; 
@Column (name = "Pwd") 
Private String pwd; 


Poowawmwwm 


口 
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1 // 省 略 必要 的 setter 和 getter 方法 
i2° 


从 第 2 行 代 码 中 , 我们 能 看 到 该 类 将 和 MySQL 中 的 User 数据 表 相 对 应 ; 通过 第 5~10 行 代码 ， 
我 们 能 看 到 User 类 和 User 数据 表 中 属性 和 列 名 的 对 应 关系 。 
步骤 02h 在 控制 器 Controller 类 中 添加 处 理 login 登录 请 求 的 login 方法 ， 关 键 代码 如 下 。 


1 ”@Autowired // 将 自动 引入 studentService 

2 Private UserService userService; 

3 @RequestMapping (value = "/login",method=RequestMethod.POST) 

4 Public ModelAndView login (QRequestParam("userName") String userName, 
@RequestParam("userPwd") String userPwd) { 

5 // 身 份 验证 

6 User user = userService.findByName (userName) .get (0); 

学 if(user !=null && user.getPwd() .equals (userPwd) ){ 

8 ModelAndView modelAndView = new ModelRaAndView("welcome") 7 

9 modelaAndView.addobject ("loginName", "userName"); 

10 return modelAndView; 

tt } 

六 else{ 

3 ModelAndView modelAndView = new ModelandView("1ogin") 7 

14 return modelAndView; 

5 } 

16 } 


从 第 3 行 中 ， 我 们 能 看 到 ， 定 义 在 第 4 行 的 login 方法 可 以 处 理 Post 形式 的 /login 请 求 ， 而 在 
第 4 行 的 login 方法 参数 定义 中 ， 我 们 能 看 到 该 方法 是 通过 @RequestParam 注解 的 ， 接 收 到 从 前 端 
JSP 页 面 中 传 来 的 名 为 userName 和 userPwd 的 两 个 参数 。 

在 这 个 login 方法 中 ， 我 们 首先 通过 第 6 行 代 码 ， 使 用 usrerService 层 的 方法 验证 输入 用 户 名 
和 密码 ， 如 果 能 和 数据 库 中 的 匹配 上 ， 就 走 第 8~10 行 的 流程 ， 最 终 跳 转 到 welcome.jsp 页 面 上 ， 
否则 就 根据 第 13 行 和 第 14 行 的 逻辑 跳 转 回 login.jsp 页 面 上 。 


步 野 034 在 application.yml 中 定义 连接 MySQL 部 分 的 配置 人 参数， 相关 代 码 如 下 。 


1 spring: 

2 jpa: 

3 show-sql: true 

4 datasource: 

5 url: jdbc:mysql://localhost:3306/springboot 
6 username: root 

时 Password: 123456 

8 driver-class-name: com.mysql.jdbc.Driver 


从 中 ， 我 们 能 看 到 本 项 目 通 过 JPA 连接 到 MySQL 的 具体 参数 ， 比 如 连接 ul、 连接 用 户 名 和 
密码 以 及 连接 所 用 到 的 驱动 程序 。 
步骤 04 定义 Service 层 和 Repository 层 的 代码 。 由 于 这 两 部 分 的 代码 在 之 前 讲述 JPA 部 分 
时 已 经 分 析 过 ， 所 以 这 里 不 做 过 多 的 说 明 。 


Service 层 的 UserService.java 代码 如 下 ， 在 其 中 的 findByName 方法 中 调用 Repository 层 的 相 
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关 代码 ， 从 数据 表 中 根据 name 获得 相关 记录 。 
// 省 略 必 要 的 package 和 import 代码 


@Service 
Public class UserService { 
@Autowired 
Private UserRepository userRepository; 
public List<User> findByName (String name) 0 
return userRepository.findByName (name); 


也 


FE 


oAMAwWN 


} 


而 UserRepository 类 的 代码 如 下 ， 在 其 中 的 第 5 行 中 ， 通 过 findByName 方法 根据 第 4 行 定义 
的 SQL 语句 从 数据 表 中 得 到 相关 数据 。 
// 省 略 必 要 的 package 和 import 代码 


@Component 

public interface UserRepository extends Repository<User, Long>{ 
@Query (value = "from User s where s.name=:name") 
List<User> findByName (@Param("name") String name); 


aowwN 


} 
步骤 054 编写 包含 登录 效果 的 loginjsp 页 面 ， 相 关 代码 如 下 。 


7 <%@ page language="java" contentType="text/html; charset=UTF-8" %> 
8 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.0rg/TR/html4/loose.dtd"> 


9 <html> 

10 <head> 

J <title> 登 录 </title> 

2 </head> 

3. <body> 

14 登录 

6 <form method="post" action="/login" id="userInfo"> 
16 用 户 名 : 

二 <input name="userName" id="userName"/> 
18 <br> 

19 密码 : gnbsp; gnbsp; 

20 <input name="userPwd" id="userPwd"/> 
2 <br> 

22 <input type=submit value=" 登 录 " /> 

23 </form> 

24 </body> 

25 </html> 


在 第 15 行 定义 的 form 中 ， 不 仅 包含 用 户 名 和 密码 的 输入 框 ， 还 通过 form 中 的 action 定义 了 
一 旦 单 击 “ 登 录 ” 按 钮 ， 就 发 送出 /login 请 求 。 

完成 上 述 开发 后 ， 通 过 WebServerApp 启动 该 项 目 ， 并 输入 “http://localhost:8080/login.jsp”， 
能 够 看 到 如 图 11.1 所 示 的 登录 页 面 。 
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登录 

用 户 名 : Peter 
密码 : | 

| 登录 


图 11.1 登录 页 面 的 效果 图 


在 其 中 ， 如 果 我 们 输入 和 User 表 中 相 匹 配 的 用 户 名 和 密码 ， 并 单 击 “登录 ”按钮 ， 则 会 跳 转 
到 Controller 类 的 login 方法 中 ， 在 其 中 ,会 根据 ModelAndView 的 定义 最 终 跳 转 到 welcome.jsp 页 
面 上 。 如 果 输 入 的 用 户 名 和 密码 不 匹配 ， 就 会 回 退 到 loginjsp 页 面 。 

通过 上 述 案例 ， 我 们 能 看 到 以 Spring Boot 开发 Web 程序 的 一 般 步 又 。 和 传统 的 Spring MVC 
相 比 ， 它 们 的 差别 主要 有 如 下 三 点 。 


第 一 ，Spring Boot 可 以 通过 注解 实现 绝 大 多 数 的 功能 ， 而 无 须 像 传统 的 Spring 那样 编写 较 多 
的 XML 配置 信息 。 

第 二 ， 由 于 Spring Boot 中 内 嵌 Web 容器 〈 比 如 Tomcat) ， 因 此 能 通过 项 目的 启动 程序 快速 
地 启动 并 运行 项 目 。 

第 三 ， 以 Spring Boot 方式 开发 的 项 目 能 更 好 地 整合 Spring Cloud 的 组 件 ， 比 如 Ribbon 等 。 


11.2 ”Spring Security 与 Spring Boot 的 整合 


Spring Security 是 Spring 家 族 提 供 的 权限 管理 框架 ， 通 过 它 ， 我 们 可 以 实现 Spring Boot 微服 
务 中 的 身份 认证 和 授权 两 大 服务 功能 。 

身份 认证 (Authentication) 可 以 验证 用 户 身份 的 合法 性 。 授 权 服 务 Authorization) 也 叫 访问 
控制 ， 可 以 决定 该 用 户 开发 哪些 页 面 或 服务 。 本 项 目的 关注 点 在 于 如 何 通过 Spring Security 组 件 实 
现 身 份 认证 和 授权 服务 。 


11.2.1 身份 验证 的 简单 做 法 


某 些 页 面 ， 只 有 在 输入 正确 的 用 户 名 和 密码 的 情况 下 才能 访问 ， 否 则 不 予 开放 ， 这 是 身份 验 
证 的 一 般 做 法 。 


代码 位 置 视频 位 置 
代码 \ 第 11 章 \SpringBootSecurityProj 视频 \ 第 11 章 \ 身 份 验证 案例 


在 SpringBootSecurityProj 这 个 Maven 项 目 中 ， 我 们 将 通过 如 下 步骤 演示 Spring Security 实现 
身份 验证 的 一 般 做 法 。 


步骤 014 在 pom.xml 中 放 入 Spring Security 等 的 依赖 包 ， 关 键 代 码 如 下 。 


让 <parent> 
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2 <groupId>org.springframework.boot</groupId> 
1 <artifactId>spring-boot-starter-parent</artifactId> 
4 <version>1.5.4.RELEASE</version> 
</parent> 
6 <dependencies> 
了 <dependency> 
8 <groupId>org.springframework.boot</groupId> 
9 <artifactId>spring-boot-starter-web</artifactId> 
10 </dependency> 
11 <dependency> 
12 <groupId>org.apache.tomcat .embed</groupId> 
3 <artifactId>tomcat-embed-jasper</artifactId> 
14 </dependency> 
15 <dependency> 
16 <groupId>org.springframework.boot</groupId> 
yy <artifactId>spring-boot-devtools</artifactId> 
18 <optional>true</optional> 
19 </dependency> 
20 <dependency> 
2 <groupId>org.springframework.boot</groupId> 
22 <artifactId>spring-boot-starter-security</artifactId> 
23 </dependency> 
24 </dependencies> 


在 上 述 第 7~19 行 代码 中 ， 我 们 引入 了 Spring Boot 以 及 支持 JSP 的 依赖 包 ， 而 在 第 20~23 行 


中 ， 我 们 引入 了 Spring Boot Security 的 依赖 包 。 
步 又 024 在 application.yml 中 编写 针对 本 项 目的 配置 信息 ， 代 码 如 下 。 


server: 
port: 8080 
spring: 
mve: 
View: 
prefix: / 
Suffix dep 


这 部 分 代码 和 11.1 节 案 例 中 的 一 致 , 也 是 指定 该 项 目 工作 在 8080 


aowmwwn 


页 面 的 前 级 和 后 级 。 
步骤 034 在 WebServerApp 类 中 编写 启动 逻辑 ， 这 和 SpringCloudJspProj 项 目 中 的 很 相似 ， 
所 以 就 不 再 详细 说 明了 。 


靖 口 ， 


同样 指定 了 针对 Web 


在 form 中 ， 用 户 名 和 密码 的 名 字 分 别 是 username 和 password， 如 下 所 示 。 如 果 这 两 个 


名 字 有 所 改变 ， 就 有 可 能 影响 身份 验证 的 效果 。 


1 <form method="post" action="/login" id="userInfo"> 


用 户 名 :” <input name="usemame" id="username"/> 
<br> 密码 : &nbsp;&nbsp; 
<input name="password" id="password"/> 
<br><input type=submit value=" 登 录 " /> 

</form> 
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步 又 044 在 SecurityConfigjava 中 编写 实现 权限 控制 功能 的 相关 逻辑 ， 代 码 如 下 。 


二 / /省略 必要 的 package 和 import 代码 

2 @Configuration 

3 ”QEnableWebSecurity // 启 动 Web 安全 管理 ， 这 里 用 到 了 授权 的 功能 

4 public class SecurityConfig extends WebSecurityConfigurerAdapter { 

号 Q@Override 

6 Protected void configure(HttpSecurity http) throws Exception { 

7 http.authorizeRequests () 

8 .antMatchers ("/", "/otherPages/") .permitAl1()// 定 义 无 需 认证 的 url 

9 .anyRequest () .authenticated() 

10 -and() 

这 .formLogin () .loginPage ("/login")// 定 义 需要 认证 时 ， 跳 转 到 的 登录 页 面 

2 .PermitAll () 

3 .and() 

14 .logout () 

15 .PermitAll (); 

16 http.csrf() .disable(); 

LT } 

18 @Autowired 

19 public void configureGlobal (AuthenticationManagerBuilder 
authentication) throws Exception { 

20 authentication.inMemoryAuthentication() 

21 .withUser ("Admin") .password ("123456") .roles ("USER"); 

22 } 

.30 


securityConfig 类 需要 如 第 4 行 那样 继承 WebSecurityConfigurerAdapter 类 ， 并 如 第 6 行 那样 重 
写 configure 方法 。 在 configure 方法 中 ， 主 要 通过 第 7 行 的 代码 定义 需要 和 无 须 认 证 的 url 资源 。 

具体 来 讲 ， 是 通过 第 8 行 代码 定义 无 须 认 证 的 url 列表 ， 这 里 的 参数 有 两 个 值 ， 分 别 是 /和 
/otherPages/， 也 就 是 说 ， 这 两 类 url 可 以 直接 访问 。 而 对 于 其 他 格式 的 url， 则 需要 首先 通过 如 第 
11 行 指定 的 /login 页 面 认证 才能 访问 。 

而 且 ， 在 第 19 行 的 configureGlobal 方法 中 ， 我 们 定义 了 一 个 角色 (role) 是 USER 的 用 户 ， 
它 的 用 户 名 和 密码 分 别 是 Admin 和 123456。 


步骤 054 编写 控制 器 类 Controllerjava， 代 码 如 下 。 


1 “// 省 略 必 要 的 Package 和 import 代码 

2 “RestController 

3 public class Controller { 

4 @RequestMapping ("/") 

5 Public ModelAndView index() { 

6 return new ModelAndView ("index"); 
多 } 

8 @RequestMapping ("/login") 

9 Public ModelAndView login() { 

10 return new ModelAndView ("login"); 
hl } 

hb @RequestMapping ("/welcome") 

3 Public ModelAndView welcome() { 

14 return new ModelAndView ("welcome"); 


Lm } 
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在 这 个 类 中 , 我 们 分 别 通过 三 个 方法 指定 了 三 类 url 格式 所 对 应 的 处 理 类 , 而 在 每 个 处 理 类 中 ， 
则 是 通过 ModelAndView 对 象 指定 返回 的 JSP 页 面 。 

最 后 ， 需 要 在 src/main/webapp 目录 中 定义 三 个 JSP 页 面 ， 分 别 对 应 “/” 格 式 url 的 index.jsp、 
对 应 “/login” 的 loginjsp 和 对 应 “welcome” 的 welcome.jsp。 这 三 个 页 面 的 功能 比较 简单 ， 所 以 
就 不 再 给 出 详细 的 代码 ， 大 家 可 以 在 本 书 附带 的 代码 中 自行 阅读 。 

通过 WebServerApp 类 启动 该 项 目 后 ， 我 们 能 通过 如 下 动作 看 到 权限 控制 的 效果 。 

第 一 ， 在 浏览 器 中 输入 “http://localhost:8080/”， 能 够 看 到 index.jsp 页 面 的 效果 ， 这 是 因为 我 
们 在 SecurityConfig 类 的 configure 方法 中 指定 了 “/” 格 式 的 url 无 须 验 证 ， 所 以 直接 按 Controller 
类 中 的 定义 跳 转 到 index.jsp 页 面 。 

第 二 ， 在 浏览 器 中 输入 “http:Wlocalhost:8080/welcome”， 虽 然 按 在 Controller 中 的 定义 应 该 能 
跳 转 到 welcome.jsp 页 面 ， 但 由 于 “/welcome” 格 式 的 url 不 在 “无 须 验 证 ”的 url 列表 中 ， 因 此 会 
跳 转 到 login.jsp 页 面 。 


在 这 个 登录 页 面 中 ， 如 果 我 们 输入 Admin 作为 用 户 名 、123456 作为 密码 ， 就 可 以 成 功 地 跳 转 
到 welcome 页 面 ， 和 否则 由 于 无 法 通过 验证 ， 因 此 将 跳 回 loginjsp 页 面 。 


11.2.2 ”进行 动态 身份 验证 的 做 法 


在 11.2.1 小 节 , 我 们 是 在 SecurityConfig 类 的 configureGlobal 方法 中 国定 地 设置 了 用 户 名 和 密 
码 ， 但 在 实际 的 项 目 中 一 般 不 会 这 么 做 。 本 小 节 将 修改 上 述 案 例 ， 以 实现 动态 身份 验证 的 效果 。 


修改 点 1: 在 SecurityConfig 类 中 注释 掉 configureGlobal 方法 。 
修改 点 2: 新 建 com.service 这 个 pacakge 包 ， 并 在 其 中 创建 一 个 名 为 MyUserDetailsService 的 
类 ， 关 键 代码 如 下 。 


1 “// 省 略 必要 的 package 和 import 代码 

ecomponent // 以 此 注解 说 明 本 类 是 一 个 Service 

public class MyUserDetailsService implements UserDetailsService { 
// 实 现 1oadUserByUsername 方法 
@Override 
Public UserDetails loadUserByUsername (String username) throws 
UsernameNotFoundException { 

5 return new User (Username， "myPassword",AuthorityUtils. 

commaSeparatedStringToAuthorityList ("USER")); 


aowm 必 wm 


8 } 

9 

这 个 类 需要 如 第 3 行 那样 实现 UserDetailsService 接口 ， 并 如 第 6 行 所 示 重 写 (Override) 该 接 
口中 的 loadUserByUsemame 方法 。 在 该 方法 的 第 7 行 ， 我 们 创建 了 一 个 User 对 象 ， 它 的 前 两 个 参 
数 分 别 说 明 该 User 的 用 户 名 和 密码 ， 第 3 个 参数 表示 该 User 的 权限 。 

当 我 们 输入 localhost:8080/welcome 后 , 会 跳 转 到 login 登录 窗口 , 在 该 窗口 中 输入 用 户 名 和 密 
码 ， 单 击 “ 登 录 ” 按 钮 后 ， 会 触发 loadUserByUsername 方法 ， 而 在 登录 窗口 中 输入 的 用 户 名 则 是 
该 方法 的 参数 。 
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在 这 里 ， 不 论 用 户 名 是 什么 ， 只 要 密码 是 “myPassword”， 均 能 以 USER 的 角色 通过 验证 。 
事实 上 ， 这 里 我 们 还 可 以 连接 到 数据 库 ， 根 据 输入 的 usemame 到 数据 表 中 找 对 应 的 密码 ， 只 有 当 
匹配 上 的 时 候 才 能 通过 验证 。 这 部 分 的 代码 和 身份 验证 无 关 , 所 以 这 里 我 们 只 给 出 简单 的 验证 逻辑 。 


11.2.3 ”Spring Boot Security 身份 验证 的 开发 要 点 


在 11.2.1 小 节 和 11.2.2 小 节 , 我 们 实现 了 身份 验证 的 功能 代码 ,其 中 用 到 了 Spring Boot Security 
提供 的 注解 和 接口 。 下 面 我 们 来 归纳 开发 要 点 。 


要 点 一 ， 需 要 像 SecurityConfig 类 那样 继承 〈extends ) Spring Boot Security 提供 的 
WebSecurityConfigurerAdapter 类 ， 并 添加 @EnableWebSecurity 注解 。 

要 点 二 ， 实 现 configure 方法 ， 在 其 中 指定 无 须 和 需要 身份 验证 的 页 面 ， 并 可 以 指定 需要 验证 
时 跳 转 的 目标 页 面 ， 比 如 这 里 是 login.jsp。 

要 点 三 , 我 们 可 以 通过 configureGlobal 方法 在 内 存 中 指定 用 户 名 密码 和 该 用 户 的 角色 (Role) ， 
也 可 以 像 MyUserDetailsService 类 那样 实现 Spring Boot Security 提供 的 UserDetailsService 接口 , 并 
通过 重 写 其 中 的 loadUserByUsername 方法 验证 从 login 页 面 传 来 的 用 户 登 录 信息 。 
这 里 为 了 演示 方便 ， 我 们 直接 在 代码 中 指定 了 能 通过 验证 的 密码 ， 在 实际 的 项 目 中 ， 我 们 也 
可 以 根据 username 到 数据 库 中 匹配 该 用 户 的 登录 信息 。 
要 点 四 ，loadUserByUsername 方法 返回 的 是 Spring Boot Security 提供 的 UserDetails 对 象 ， 在 
代码 中 ， 我 们 通过 构造 函数 指定 了 该 对 象 的 用 户 名 、 密 码 和 角色 。 该 对 象 的 内 部 代码 如 下 ， 在 实际 
的 项 目 中 ， 我 们 可 以 根据 需求 重 写 该 类 相关 的 方法 来 细 化 用 户 登 录 的 相关 逻辑 。 
// 返 回 用 户 名 和 密码 
String getUsername () 7 
String getPassword() 
// 在 该 方法 中 可 以 写 判断 该 用 户 是 否 是 过 期 的 逻辑 
boolean isAccountNonExpired(); 
// 在 该 方法 中 可 以 写 判断 该 用 户 是 否 是 被 锁定 的 逻辑 
boolean isAccountNonLocked(); 
// 可 以 写 判断 用 户 的 登录 凭证 (比如 密码 ) 是 否 是 过 期 的 逻辑 
boolean isCredentialsNonExpired(); 


0 ”// 可 以 写 判断 该 用 户 是 否 是 被 禁用 的 逻辑 
加 


boolean isEnabled() 


上 


PPheoowanumwwb 


11.2.4 根据 用 户 的 角色 分 配 不 同 的 资源 
Spring Boot Security 除了 可 以 实现 身份 验证 之 外 ， 还 可 以 实现 “角色 授权 ”的 功能 ， 即 根据 不 
同 用 户 的 角色 为 之 开放 不 同 的 ur 资源 ， 在 这 部 分 的 案例 中 ， 我 们 将 实现 这 个 效果 。 


代码 位 置 视频 位 置 
代码 \ 第 11 章 \SpringBootAuthProj 视频 第 11 章 \ 根 据 角 色 分 配 不 同 的 资源 


这 个 项 目 是 在 之 前 SpringBootSecurityProj 的 基础 上 改编 而 成 的 ， 具 体 包 含 如 下 修改 点 。 
修改 点 1: 在 设置 授权 配置 的 SecurityConfig 类 中 增加 一 个 授权 相关 的 拦截 器 对 象 
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securityInterceptor， 并 在 configure 配置 方法 中 启用 这 个 拦截 器 ， 关 键 代码 如 下 。 


1 // 省 略 其 他 不 相关 的 代码 
2 Public class SecurityConfig extends WebSecurityConfigurerAdapter { 
a // 安 全 相关 的 拦截 器 ， 通 过 它 可 以 实现 权限 管理 
4 QRAutowired 
Private SecurityInterceptor securityInterceptor; 
6 @Override 
ys Protected void configure(HttpSecurity http) throws Exception { 
8 http 
9 .authorizeRequests () 
10 .antMatchers ("/"，"/otherPages/") .PermitRll() 
// 定 义 无 须 认证 的 url 
JU .anyRequest () .authenticated () 
12 .and () 
3 .formLogin() 
14 .loginPage("/1login") // 定 义 需 要 认证 时 ， 跳 转 到 的 登录 页 面 
5 .PermitAll () 
16 .and() 
二 .logout () 
18 .PermitAll (); 
19 http.csrf() .disable(); 
0 http.addFilterBefore(securityInterceptor, 
FilterSecurityInterceptor.class); 
fb } 
22 // 省 略 其 他 不 相关 的 代码 
i 
Configure 方法 的 其 他 代码 没 变 , 在 第 20 行 中 , 我 们 添加 了 securityInterceptor 拦截 器 ， 一 旦 跳 
转 到 需要 身份 验证 的 页 面 ， 比 如 welcome， 就 会 触发 这 个 拦截 器 。 


下 。 


修改 点 2: 在 com.service 这 个 package 中 编写 SecurityInterceptor 拦截 器 的 逻辑 ， 相 关 代码 如 


15 
16 


// 省 略 必要 的 package 和 import 代码 
@Service 
public class SecurityInterceptor extends AbstractSecurityInterceptor 
implements Filtert{ 
@Autowired 
Private FilterInvocationSecurityMetadataSource 
securityMetadataSource; 
@Autowired 
Public void setMyAccessDecisionManager (MyAccessDecisionManager 
myAccessDecisionManager) { 
super.setAccessDecisionManager (myAccessDecisionManager); 
@Override 
Public void doFilter (ServletRequest request, ServletResponse response, 
FilterChain chain) { 
invoke (new FilterIinvocation(request, response, chain)); 
} 
Public void invoke (FilterInvocation filterinvocation) { 
// 调 用 之 前 拦截 器 中 的 动作 


InterceptorStatusToken token = super. 
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beforeInvocation (filterinvocation) 7 
7 try { 
18 //getCchain 是 以 责任 链 的 方式 调用 下 一 个 拦截 器 中 的 动作 
19 filterinvocation.getChain().doFilter (filterinvocation.getRequest(), 
filterinvocation.getResponse()); 


20 } catch (IOException e) { 

2 e.printStackTrace (); 

22 } catch (ServletException e) { 
23 e.printStackTrace () 7 

24 } finally { 

25 // 调 用 之 后 拦截 器 的 动作 

26 super.afterInvocation (token, null); 
2 } 

28 } 

29 // 省 略 其 他 无 关 的 代码 

302 


一 旦 触发 该 拦截 器 ， 就 会 自动 调用 第 11 行 的 doFilter 方法 。 在 该 方法 中 
的 invoke 方法 ， 在 现 有 的 拦截 器 链 中 新 增 一 个 “权限 验证 ”相关 的 方法 。 

有 具体 来 说 , 在 invoke 方法 的 第 16 行 中 会 自动 调用 FilterInvocationSecurityMetadataSource 实现 
类 (这 里 是 MySecurityMetadataSourceService ) 的 getAttributes 方法 ， 以 获取 该 方法 参数 
filterinvocation 所 对 应 请 求 的 相关 权限 ， 再 用 AccessDecisionManager 实现 类 (这 里 是 
MyAccessDecisionManager) 的 decide 方法 来 判断 访问 包含 在 filterinvocation 中 的 url 用 户 是 否 有 足 
够 的 权限 。 


我 们 调用 了 第 14 行 


上 述 提 到 的 “自动 调用 ”动作 是 由 Spring Boot Security 框架 自动 完成 的 。 


修改 点 3: 编写 管理 权限 相关 信息 的 FilterInvocationSecurityMetadataSource 接口 的 实现 类 
MySecurityMetadataSourceService。 在 该 类 中 ， 我 们 模拟 了 从 数据 库 中 获取 权限 的 步骤 ， 并 把 权限 
和 url 的 对 应 关系 以 HashMap 的 方式 返回 给 SecurityInterceptor 拦截 器 。 


1 “// 省 略 必 要 的 package 和 import 代码 

2 Service 

3 public class MySecurityMetadataSourceService implements 

4 FilterIinvocationSecurityMetadataSource { 

5 // 键 是 ur1， 值 是 权限 列表 ， 通 过 该 对 象 可 以 说 明 可 以 给 每 个 url 开放 哪些 权限 

6 Private HashMap<String, Collection<ConfigAttribute>> authMap; 

也 // 加 载 所 有 权限 

8 Public void loadAllPermission(){ 

9 authMap = new HashMap<String, Collection<ConfigAttribute>>(); 
10 List<MyPermission> permissionList = new ArrayList<MyPermission>(); 
11 // 这 里 模拟 从 数据 库 中 获取 

12 PpermissionList.add (new MyPermission("admin","welcome.jsp")); 
13 // 省 略 其 他 加 载 权限 的 动作 

14 for (MyPermission Permission : PermissionList) { 

is5. String Url = permission.getUr]l(); 

16 String PermissionName = permission.getAuthName(); 

Bh ConfigAttribute permissionConfig = new 


SecurityConfig (permissionName); 
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18 
19 
20 
人 


22 
23 
24 
25: 
26 
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if(authMap.containsKey (ur1)){ 

authMap .get (url) .add (permissionConfig); 

jelsef 
List<ConfigAttribute> configList = new 
ArrayList<ConfigAttribute>(); 
configList.add (permissionConfig); 
authMap.put (url, configList); 

} 


由 


在 第 8 行 的 loadAllPermission 方法 中 ， 我 们 首先 通过 类 似 第 12 行 的 方法 把 权限 相关 的 信息 放 
入 permissionList 对 象 中 ， 该 对 象 是 List<MyPermission> 类 型 的 ， 而 MyPermission 则 是 我 们 自己 定 
义 的 ， 其 中 包含 权限 名 称 (authName) 和 该 权限 能 访问 到 的 url 信息 。 这 里 我 们 是 直接 赋予 的 ， 在 
实际 项 目 中 ， 还 可 以 从 数据 库 中 动态 地 获取 相关 数据 。 

而 在 第 14 行 的 for 循环 中 , 我们 通过 遍历 permissionList 对 象 给 authMap 对 象 赋值 。 具体 的 做 
法 是 ， 如 果 该 HashMap 的 Key 中 还 没有 url 信息 ， 就 放 入 该 url 以 及 该 url 所 对 应 的 权限 列表 ， 如 
果 已 经 有 了 ， 就 取出 该 url 所 对 应 的 权限 列表 ， 并 在 该 权限 列表 的 最 后 放 入 新 的 权限 值 。 该 方法 执 
行 后 ， 我 们 能 得 到 一 个 描述 url 和 对 应 权限 的 HashMap 类 型 的 authMap 对 象 。 


27 
28 


29 
30 
3 于 
32 


SS 
34 
35 
36 
3 


38 
转交 
40 
41 
42 
43 
44 
45 
46 


} 


@Override 
Public Collection<ConfigAttribute> getAttributes (Object object) 
throws IllegalArgumentException { 
if (authMap ==nul11){ 
loadAllPermission(); 
} 
HttpServletRequest request = ((FilterInvocation) object) . 
getHttpRequest (); 
AntPathRequestMatcher matcher; 
Iterator it=authMap .entrySet () .iterator(); 
while (it.hasNext ()) 
{ 
Map.Entry<String, Collection<ConfigAttribute>> 
entry=(Entry<String, Collection<ConfigAttribute>>) it.next(); 
matcher = new AntPathRequestMatcher (entry.getKey ()); 
if (matcher.matches (request)) { 
return authMap.get (entry.getKey()); 
} 
} 
return null; 
3 
// 省 略 其 他 不 相关 的 代码 


在 第 28 行 getAttributes 方法 的 入 参 object 对 象 中 包含 请 求 对 象 request， 通 过 第 35 行 的 while 
循环 ， 我 们 依次 遍历 authMap 对 象 ， 并 在 第 39 行 ， 通 过 AntPathRequestMatcher 类 型 的 matcher 对 
象 ， 从 authMap 中 找到 请 求 对 象 request 中 包含 的 url 所 对 应 的 权限 列表 并 返回 。 请 注意 ， 该 方法 
返回 的 是 Collection<ConfigAttribute> 类 型 的 包含 权限 信息 的 对 象 。 

修改 点 4: 编写 用 于 匹配 url 以 及 对 应 用 户 权限 的 AccessDecisionManager 接口 的 实现 类 
MyAccessDecisionManager， 上 有 具体 代码 如 下 。 
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1 “// 省 略 必 要 的 package 和 import 代码 

之 Service 

3 Ppublic class MyAccessDecisionManager implements AccessDecisionManager { 

4 // 判 断 该 用 户 是 否 有 权限 访问 指定 的 url 

与 @Override 

6 Public void decide (Authentication authentication, Object object, 
Collection<ConfigAttribute> configAttributes) throws 
AccessDeniedException, InsufficientAuthenticationException { 

Iterator<ConfigAttribute> iter = configAttributes.iterator(); 

8 while( iter.hasNext() ) { 

9 ConfigAttribute configAttribute = iter.next(); 

10 for (GrantedAuthority auth : authentication.getAuthorities()) { 

11 // 对 比 由 参数 传 入 的 用 户 是 否 有 访问 网 页 的 权限 

12 if( auth.getAuthority() .equals (configAttribute.getAttribute()) ) { 

13 // 若 匹配 到 权限 ， 则 退出 ， 继 续 后 继 流程 

14 return; 

5 } 

16 } 

二 上 

18 // 如 果 都 没 匹 配 到 

19 throw new AccessDeniedException("No enough Ruthority") 

20 } 

21 // 省 略 其 他 不 相关 的 代码 

| 


在 分 析 之 前 的 拦截 器 相关 的 代码 时 ， 我 们 就 已 经 提 到 ，Spring Boot Security 会 在 装载 完 权限 列 
表 后 ， 通 过 调用 AccessDecisionManager 实现 类 ( 即 该 类 ) 的 decide 方法 来 判断 用 户 是 否 有 访问 url 
的 权限 。 

在 上 述 代码 第 6 行 的 decide 方法 中 ， 我 们 通过 第 8 行 的 while 循环 和 第 10 行 的 for 循环 依次 
对 比 包含 在 入 参 authentication 中 的 用 户 权 限 和 包含 在 入 参 configAttributes 中 的 页 面 权限 ， 以 判断 
该 用 户 是 否 有 权限 访问 待 请 求 的 页 面 。 

如 果 匹 配 上 ， 就 说 明 有 权限 访问 ， 通 过 第 14 行 的 return 代码 返回 ， 把 控制 权 交还 给 拦截 器 ， 
由 拦截 器 继续 调用 后 继 流程 ， 如 果 没 匹配 上 ， 就 说 明 没 权 限 ， 通 过 第 19 行 的 throw 方法 抛 出 包含 
“No enough Authority” 信 息 的 异常 。 

修改 点 5: 在 MyUserDetailsService 类 的 loadUserByUsername 方法 中 为 user 赋予 一 个 
GrantedAuthority 类 型 的 权限 ， 关 键 代 码 如 下 。 


证 @Override 

2 Public UserDetails loadUserByUsername (String username) throws 
UsernameNotFoundException { 

入 List<GrantedAuthority> userAuthorities = new ArrayList 
<GrantedAuthority>(); 

4 GrantedAuthority grantedAuthority = new 


SimpleGrantedAuthority("admin"); 
userAuthorities.add (grantedAuthority); 
User user = new User (username， "myPassword",userAuthorities); 
return user; 


oa 


| 
这 里 关键 是 第 6 行 创建 User 对 象 的 代码 ， 这 里 我 们 通过 userAuthorities 对 象 为 登录 的 用 户 赋 
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了 予 了 admin 的 权限 。 

这 里 为 了 突出 “授权 ”的 主题 ， 忽 略 了 与 数据 库 交 互 部 分 的 代码 ， 事 实 上 ， 我 们 可 以 从 数据 
库 中 得 到 该 登录 用 户 的 所 有 权限 ， 并 如 第 4 行 和 第 5 行 那样 ， 把 所 有 的 权限 添加 到 userAuthorities 
对 象 中 ， 并 通过 第 6 行 的 User 构造 函数 ， 使 用 第 3 个 参数 传 入 该 用 户 的 所 有 权限 。 

至 此 ， 授 权 部 分 的 代码 开发 完成 。 下 面 我 们 通过 具体 的 页 面 访问 流程 来 看 上 述 代 码 的 工作 步 
又 。 


流程 1: 在 浏览 器 中 输入 “1localhost:8080/welcome”， 则 会 跳 转 到 login 登录 页 面 ， 这 部 分 的 
流程 之 前 已 经 分 析 过 。 而 且 我 们 还 知道 ， 当 输入 任意 用 户 名 与 myPassword 密码 后 ， 会 触发 
MyUserDetailsService 类 的 loadUserByUsername 方法 。 

流程 2; 由 于 在 SecurityConfig 类 的 configure 方法 中 通过 addFilterBefore 方法 添加 了 拦截 器 ， 
因此 在 登录 请 求 被 处 理 前 ， 会 辊 转 触发 拦截 器 securityInterceptor 类 中 的 invoke 方法 。 在 该 方法 中 ， 
会 触发 MySecurityMetadataSourceService 类 的 getAttributes 方法 ,在 这 个 方法 中 ,首先 会 以 HashMap 
的 形式 装载 url 和 该 url 所 对 应 的 访问 权限 ， 并 从 中 得 到 访问 目标 url 所 需要 的 权限 列表 。 

流程 3: 会 触发 MyAccessDecisionManager 类 的 decide 方法 ， 在 这 个 方法 中 ， 会 用 访问 该 url 
的 用 户 所 拥有 的 权限 和 访问 目标 url 所 需要 的 权限 相 匹 配 ,如 果 匹 配 上 (这 里 需要 的 权限 都 是 admin， 
所 以 能 匹配 上 ) ， 最 终 的 结果 是 该 用 户 能 访问 welcome 这 个 页 面 。 


此 处 为 了 突出 “权限 管理 ”的 主流 程 ， 用 户 信息 、 权 限 信息 以 及 url 和 权限 的 对 应 关系 都 


是 在 代码 中 国定 赋予 的 ， 在 实际 项 目 中 ， 这 些 信息 均 是 存储 在 数据 表 中 的 ， 大 家 可 以 在 
获取 相应 信息 的 位 置 自行 扩展 出 “从 数据 表 中 得 到 相关 数据 ”的 功能 实现 点 。 


11.3 在 Web 项 目 中 整合 Eureka、Ribbon 等 组 件 


在 单机 版 的 Spring MVC 项 目 中 , 前 端 页 面 (比如 JSP 页 面 ) 发 出 的 请 求 经 控制 器 (Controller) 
转发 后 ， 会 通过 调用 本 地 的 Service 层 中 的 方法 得 到 结果 并 展示 在 前 端 页 面 中 。 此 外 ， 在 实际 项 目 
中 ， 我 们 还 可 以 整合 Web 项 目 与 Eureka 和 Ribbon 实现 负载 均衡 的 效果 。 

本 项 目的 关注 点 在 于 如 何 实现 前 后 端 服务 的 分 离 。 有 具体 而 言 ， 第 一 ， 如 何 把 提供 相同 服务 的 
不 同 模块 以 负载 均衡 的 方式 注册 到 Eureka 服务 器 上 ; 第 二 ， 如 何在 前 端 JSP 页 面 中 调用 注册 在 
Eureka 的 服务 ;第 三 ， 在 项 目 中 综合 使 用 JPA、Feign 和 Hystrix 组 件 的 方法 。 


11.3.1 本 案例 的 框架 与 包含 的 项 目 说 明 


在 这 个 案例 中 ， 我 们 将 演示 如 下 效果 。 


@ ”用户 可 以 在 前 端 登录 页 面 输入 用 户 名 和 和 密码， 进行 登录 操作 。 
@ 用 户 输入 的 登录 信息 将 会 使 用 用 户 管理 模块 进行 验证 ， 如 果 正 确 ， 就 能 进行 后 继 操 作 。 
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”通过 验证 后 ， 前 端 页 面 会 请 求 账户 管理 模块 的 方法 ， 获 取 该 用 户 的 账户 余额 ， 并 在 欢迎 页 
面 演示 。 


该 案例 的 框架 如 图 11.2 所 示 。 


用 户 管理 模块 
账户 管理 模块 账户 管理 模块 


7 
11.2 综合 案例 的 框架 说 明 图 


在 表 11.2 中 ,我 们 能 看 到 这 个 案例 中 包含 的 项 目 列表 ， 以 及 针对 每 个 项 目 功能 的 说 明 。 
表 11.2 案例 中 包含 的 项 目 功 能 说 明 表 


项 目 名 功能 说 明 
包含 前 端 页 面 ， 本 身 也 作为 Eureka 客户 端 向 Eureka 服务 
UIProj 器 注册 ， 以 获取 其 他 模块 的 服务 
该 项 目 整合 了 Hystrix、Ribbon 和 Feign 等 组 件 
ee. EN Eureka 服务 器 ， 诸 多 提供 服务 功能 的 Eureka 客户 端 均 向 
该 服务 器 注册 
UserServicePro) 提供 用 户 身份 验证 功能 的 项 目 ， 本 身 是 Eureka 客户 端 ， 
向 Eureka 服务 器 注册 
AccountServiceProjRibbon1 提供 账户 查询 功能 的 项 目 ， 以 Ribbon 形式 实现 负载 均衡 ， 
本 身 也 是 Eureka 客户 端 。 
AccountServiceProjRibbon2 | 在 这 两 个 项 目 中 ， 均 通过 JPA 连接 MySQL 数据 库 


11.3.2 ”开发 Eureka 服务 器 模块 


在 EurekaServerForMoreFunc 项 目 中 ， 我 们 实现 了 Eureka 服务 器 的 功能 。 

由 于 我 们 在 之 前 的 项 目 中 多 次 讲述 过 Eureka 服务 器 的 代码 和 功能 ， 而 且 该 服务 器 项 目的 代码 
和 之 前 的 非常 相似 , 因此 这 里 就 不 再 给 出 代码 和 说 明了 , 请 大 家 自行 阅读 本 书 附带 代码 中 的 相关 间 
分 。 不 过 请 注意 ， 该 Eureka 服务 器 同样 是 工作 在 8888 端口 上 的 。 


11.3.3 ”开发 前 端 Web 项 目 


在 UIProj 这 个 Maven 项 目 中 ， 我 们 实现 了 前 端 相 关 的 功能 代码 ， 其 中 主要 包含 如 下 文件 。 


第 一 ， 在 pom.xml 文件 中 ， 我 们 引入 了 JSP、Ribbon、Eureka、Feign 和 Hystrix 等 组 件 的 依赖 
包 ， 关 键 代码 如 下 。 
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1 <dependencies> 

之 <dependency> <! 一 Spring Boot 依赖 包 --> 

2 <groupId>org.springframework.boot</groupId> 

4 <artifactId>spring-boot-starter-web</artifactId> 

5 <version>1.5.4.RELEASE</version> 

6 </dependency> 

了 <dependency> <! 一 支持 Tomcat 的 依赖 包 --> 

8 <groupId>org.apache.tomcat .embed</groupId> 

9 <artifactId>tomcat-embed-jasper</artifactId> 

10 </dependency> 

了 <dependency> <! 一 支持 热 部 署 的 依赖 包 --> 

1 be <groupId>org.springframework.boot</groupId> 

i <artifactIid>spring-boot-devtools</artifactId> 

14 <optional>true</optional> 

15 </dependency> 

16 <dependency> <! 一 支持 负载 均衡 Ribbon 组 件 的 依赖 包 --> 

| <groupId>org.springframework.cloud</groupId> 

18 <artifactId>spring-cloud-starter-ribbon</artifactId> 
19 </dependency> 

20 <dependency> <! 一 支持 Eureka 组 件 的 依赖 包 --> 

2 <groupId>org.springframework.cloud</groupId> 

22 <artifactId>spring-cloud-starter-eureka</artifactId> 
23 </dependency> 

24 <dependency> <! 一 支持 Feign 组 件 的 依赖 包 --> 

5 <groupId>org.springframework.cloud</groupId> 

26 <artifactId>spring-cloud-starter-feign</artifactId> 
2 </dependency> 

28 <dependency> <! 一 支持 Hystrix 组 件 的 依赖 包 --> 

29 <groupId>org.springframework.cloud</groupId> 

30 <artifactId>spring-cloud-starter-hystrix</artifactId> 
31 </dependency> 

32 </dependencies> 


第 二 ,在 WebServerApp 类 中 实现 了 启动 类 的 项 目 ， 相 关 代码 如 下 ， 其 中 第 2~5 行 加 入 了 支持 
多 个 组 件 的 注解 。 这 样 ， 在 本 项 目的 Controller 和 Service 等 类 中 就 能 用 到 Feign 和 Hystrix 等 组 件 
了 。 


1 “// 省 略 必要 的 Package 和 import 代码 

2  Q@EnableFeignClients // 支 持 Feign 客户 端 

3  Q@EnableDiscoveryClient // 能 调用 其 他 Eureka 客户 端 里 的 方法 

4  Q@SpringBootApplication // 能 以 Spring Boot 的 方式 启动 

5  @EnableCircuitBreaker // 引 入 Hystrix 效果 

6 Ppublic class WebServerApp extends SpringBootServletInitializer { 
¥ // 启 动 类 

8 Public static void main(String[] args) { 

9 SpringApplication.run (WebServerApp.class, args); 
10 } 

br 


第 三 ， 在 login.jsp 这 个 前 端 页 面 中 实现 了 登录 效果 ， 该 文件 在 src/main/webapp 目录 中 ， 相 关 
代码 如 下 。 


<%@ page language="java" contentType="text/html; charset=UTF-8" $%> 
2 <!DOCTYPE html PUBLIC "~-//W3C//DTD HTML 4.01 Transitional//EN" 
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"http://www.w3.org/TR/htm14/1oose.dtd"> 


3 <html> 

4 <head> 

可 <title> 登 录 </title> 

6 </head> 

y <body> 

8 登录 

9 <form method="post" action="/login" id="userInfo"> 
10 用 户 名 : 

1 <input name="username" id="username"/><br> 
12 密码 : gnbsp; gnbsp; 

13 <input name="password" id="password"/><br> 
14 <input type=submit value=" 登 录 " /> 

15 </form> 

16 </body> 

17 </html> 


当 用 户 输入 用 户 名 和 密码 后 ， 单 击 “ 登 录 ” 按 钮 ， 能 如 第 9 行 form 中 的 定义 ， 以 post 的 形式 
发 出 /login 的 请 求 ， 该 请 求 会 被 该 项 目 中 的 控制 器 〈Controller) 类 接收 并 处 理 。 
第 四 ， 在 Controller 控制 器 类 中 ， 接 收 并 处 理 请 求 ， 相 关 代 码 如 下 。 


1 // 省 略 必要 的 package 和 import 代码 

2  Q@RestController 

3  Q@Configuration 

4 public class Controller { 

5 @Autowired // 通 过 Autowired 引入 userService 对 象 

6 UserService userService; 

学 // 以 Post 的 形式 接收 /1ogin 的 请 求 ，login.j sp 的 请 求 会 被 该 方法 处 理 

8 @RequestMapping (value = "/login",method=RequestMethod.POST) 

9 Public ModelAndView login(@RequestParam("username") String 
username, @RequestParam("password") String password) { 

10 // 身 份 验证 

i boolean flag = userService.validateUser (username, password); 

ke if (flag) // 若 通过 验证 ， 则 跳 转 到 welcome 页 面 

14 ModelandView modelAndView = new ModelAndView ("welcome"); 

15 modelAndView.addObject ("username", username); 

16 String balance = userService.getAccountByName (username); 

了 网 modelandView.addobject ("balance", balance); 

18 return modelAndView; 

19 } 

20 else{ // 若 没 通过 验证 ， 则 回 到 login.jsp 页 面 

2 ModelAndView modelAndView = new ModelandView("1login") 

py return modelAndView; 

23 } 

24 } 


25 // 省 略 get 和 set 方法 

区 和 天 让 

第 9 行 的 login 方法 能 接收 并 处 理 前 端 login.jsp 发 来 的 用 户 名 和 密码 ， 并 能 通过 第 11 行 中 
userService 类 的 validateUser 方法 进行 身份 验证 。 

如 果 通 过 身份 验证 ,就 会 进入 第 13~19 行 的 让 分 支 ， 再 通过 第 16 行 的 代码 查询 该 用 户 的 账户 
余额 ， 随 后 跳 转 到 welcome 页 面 。 如 果 没 通过 ， 就 会 如 第 21 行 和 第 22 行 所 示 ， 回 退 到 登录 页 面 。 
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第 五 ， 在 UserService 类 中 定义 “身份 验证 ”和 “余额 查询 ”两 个 业务 逻辑 ， 相 关 代码 如 下 。 


ownamwm 必 wh 


// 省 略 必 要 的 package 和 import 代码 
@Service 
@Configuration 
public class UserService { 
Q@Autowired //Feign 类 
Private FeignClientTool tool; 
// 通 过 RestTemplate 对 象 能 调用 其 他 微服 务 模块 中 的 服务 
@Bean 
@LoadBalanced 
Public RestTemplate getRestTemplate() 
{ return new RestTemplate(); } 
// 身 份 验证 方法 
Public boolean validateUser (String username,String password){ 
// 调 用 服务 
Return getRestTemplate() .getForObject ("http://loginService/ 
validateUser/"tusernamet+"/"+tpassword, Boolean.class); 
} 
// 通 过 Feign 客户 端 方法 调用 账户 信息 
Public String getAccountByName (String name){ 
return tool.getAccountByName (name); 
} 
} 


这 个 类 的 两 个 方法 分 别 通 过 不 同 的 方式 来 调用 服务 。 在 第 13 行 的 validateUser 方法 中 ， 我 们 
是 在 第 15 行 中 通过 RestTemplate 对 象 ， 以 发 送 http 请 求 的 方式 实现 身份 验证 的 动作 。 而 在 第 18 
行 的 getAccountByName 方法 中 ， 我 们 是 通过 Feign 端的 tool 类 实现 获取 参数 name 的 账户 信息 。 

通过 对 比 ， 我 们 能 看 到 Feign 组 件 封装 http 请 求 的 效果 。 在 如 下 Feign 的 客户 端 类 中 ， 我 们 不 
能 看 到 getAccountByName 方法 实际 的 请 求 url 和 请 求 方式 ， 还 能 看 到 在 其 中 引入 了 Hystrix 组 件 ， 
以 实现 “服务 失效 回 退 ”的 效果 。 


22 


3 
24 
25 


26 
2 
28 
29 
30 
3 
3 
33 


@FeignClient (value = "AccountService", 
fallback=FeignClientFallback.class) 
// 在 这 个 接口 中 ， 通 过 Feign 封装 客户 端的 调用 细节 
interface FeignClientTool{ 
@RequestMapping (method = RequestMethod.GET, value = 
"/getAccount/ {name}") 
String getAccountByName (GPathVariable ("name") String name); 
上 
@Component 
class FeignClientFallback implements FeignClientTool{ 
Public String getAccountByName (String name){ 
return "In Fallback Function."; 
} 
} 


在 第 22 行 的 注解 中 , 我 们 能 看 到 第 24 行 定义 的 FeignClientTool 接口 实际 是 向 AccountService 
服务 发 起 请 求 的 ， 一 旦 服务 失效 ， 就 会 通过 第 29 行 定义 的 FeignClientFallback 类 中 的 
getAccountByName 方法 进行 “失效 回 退 ”动作 。 而 且 ， 通 过 第 25 行 的 注解 ， 我 们 能 看 到 第 26 行 
的 getAccountByName 方法 是 以 Get 的 方式 请 求 AccountService 中 的 getAccount 服务 的 。 
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也 就 是 说 ， 在 FeignClientTool 接口 中 ， 我 们 确实 能 看 到 以 Feign 的 方式 封装 调用 请 求 的 动作 。 
正 是 如 此 ， 所 以 在 第 18 行 的 getAccountByName 方法 中 ， 我 们 可 以 便捷 地 通过 Feign 对 象 请 求 
AccountService 模块 的 服务 。 

这 里 ， 我 们 还 看 到 了 User 这 个 Model 类 ， 它 的 定义 如 下 。 

1  // 省 略 Package 和 import 的 代码 


加 public class User { 

3 private String ID; //ID 

4 private String name; // 用 户 名 
5 private String pwd; // 密 码 

6 // 省 略 对 应 的 set 和 get 方法 
7 } 


第 六 ， 在 application.yml 中 定义 这 个 项 目 中 需要 用 到 的 配置 信息 ， 相 关 代 码 如 下 。 


server: 
port: 8080 
spring: 
application: 
name: WebDemo 
mve: 
View: 
Preariws 
9 suffix: .jsp 
10 eureka: 
i client: 


oawmwwm 


2 serviceUrl: 

13 defaultZone: http://localhost:8888/eureka/ 
14 feign: 

15 hystrix: 

16 enabled: true 


从 第 2 行 中 ,我 们 能 看 到 该 前 端 Web 程序 是 运行 在 8080 端口 的 ,从 第 8 行 和 第 9 行 的 代码 中 ， 
我 们 能 看 到 本 项 目 中 发 送 请 求 的 前 级 和 后 级 。 通 过 第 10~13 行 代码 ， 我 们 能 看 到 该 项 目 是 注册 到 
localhost:8888/eureka 这 个 Eureka 服务 器 上 的 ， 正 因 如 此 ， 该 项 目 才能 调用 其 他 Eureka 客户 端的 服 
务 。 从 第 14~16 行 的 代码 中 ， 我 们 能 看 到 在 Feign 中 开启 了 Hystrix 服务 。 


11.3.4 开发 提供 用 户 验 证 的 项 目 


在 UserServiceProj 这 个 Maven 项 目 中 ， 我 们 实现 了 身份 验证 的 相关 功能 ， 有 具体 的 代码 如 下 。 
第 一 ， 在 UserServerApp.java 中 编写 启动 类 ， 代 码 如 下 。 通 过 第 3 行 的 注解 ， 我 们 知道 该 项 目 
是 Eureka 的 客户 端 。 


// 省 略 package 和 import 代码 

@SpringBootApplication 

@EnableEurekaClient 

public class UserServerApp{ 
Public static void main( String[] args ){ 
SpringApplication.run(UserServerApp.class, args); 
二 


aowm 必 wm 
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} 


第 二 ， 在 Controller 类 中 实现 控制 器 类 的 代码 。 


1 
2 
2 
4 


a 


// 省 略 必要 的 package 和 import 代码 
@RestController // 通 过 注解 说 明 该 类 是 控制 器 类 
Public class Controller { 
@RequestMapping (value = "/validateUser/{username}/{password}", 
method = RequestMethod.GET ) 
Public boolean validateUser (@PathVariable ("username") String 
Username @PathVariable ("password") String password) { 
if("SpringCloud".equals (username) && "Demo" .equals (password)){ 
return true; 
} 
elsef 
return false; 
} 
} 
} 


第 5 行 的 validateUser 方法 能 处 理 如 第 4 行 注解 所 定义 的 /validateUser/{usermame}/{password} 
请 求 。 在 这 个 方法 中 ,我 们 并 没有 请 求 数据 库 ， 只 要 当 用 户 名 和 密码 满足 指定 的 字符 串 ， 即 可 通过 
身份 验证 。 

第 三 ， 在 application.yml 中 定义 本 项 目 相关 的 配置 ， 代 码 如 下 。 


oAMAGDp 


server: 
Dor Ee 
spring: 
application: 
name: loginService 
eureka: 
client: 
serviceUrl: 
defaultZone: http://localhost:8888/eureka/ 


第 2 行 的 代码 指定 了 该 项 目的 运行 端口 是 1111; 第 5 行 的 代码 指定 了 该 项 目的 名 字 ; 通过 第 
6~9 行 代 码 ， 我 们 指定 了 该 项 目 同样 是 注册 到 localhost:8888/eureka 这 个 Eureka 服务 器 上 。 


11.3.5 开发 提供 账户 查询 功能 的 项 目 〈 含 负载 均衡 ) 


在 AccountServiceProjRibbonl 和 AccountServiceProjRibbon2 两 个 项 目 中 ， 我 们 编写 了 相同 的 
账户 查询 功能 的 代码 ， 只 不 过 它们 分 别 运行 在 2222 和 2233 端口 上 ， 以 实现 负载 均衡 的 效果 。 这 两 
个 类 的 代码 非常 相似 ， 都 包含 如 下 类 和 配置 文件 。 


第 一 


，ServiceProviderApp 是 本 项 目的 启动 类 ， 相 关 代 码 如 下 。 从 第 3 行 的 注解 代码 中 ， 我 们 


能 看 到 该 项 目 是 Eureka 的 客户 端 ， 它 也 会 注册 到 Eureka 服务 上 。 


这 


2 
3 
4 


// 省 略 必 要 的 package 和 import 代码 
@SpringBootApplication 
@EnableEurekaClient 

public class ServiceProviderApp { 
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5 public static void main( String[] args ){ 

6 SpringApplication.run(ServiceProviderApp.class, args); 
7 } 

8 


二 , 在 Controllerjava 中 编写 控制 器 相关 的 代码 , 在 其 中 提供 了 根据 用 户 名 查询 余额 的 方法 。 


第 

1 @RestController 

2 public class Controller { 

3 QAutowired // 通 过 Rutowired 注 解 引 入 accountService 类 

4 AccountService accountService; 

5 // 根 据 username 查询 账户 信息 

6 @RequestMapping (value = "/getAccount/{username}", method = 
RequestMethod.GET ) 


yy! public String getAccount (@PathVariable ("username") String username) { 

8 // 该 项 目 运行 在 2222 端口 ， 而 AccountServiceProjRibbon2 项 目 运行 在 2233 端口 

9 System.out.println("Working in 2222 Port."); 

10 if(accountService.getBalanceByName (username) != null){ 

// 调 用 accountService 的 方法 查询 余额 

2 return accountService.getBalanceByName (Username) . 
getBalance() ; 

3 } 

14 else{ 

5 return "Not Found" ; 

16 } 

hr, | 

| 


根据 第 6 行 注解 中 的 定义 , 第 7~17 行 的 getAccount 方法 可 以 处 理 /getAccount/{usermame} 格 式 
的 请 求 。 在 getAccount 方 法 的 代码 中 ( 见 第 12 行 ), 调用 了 accountService 类 的 getBalanceByName 
方法 ， 查 询 该 用 户 的 余额 并 返回 。 

第 三 ， 在 UserService 类 的 getBalanceByName 方法 中 ， 调 用 基于 JPA 的 AccountRepository 类 
的 findByName 方法 ， 从 数据 库 中 查询 用 户 的 账户 信息 ， 相 关 代 码 如 下 。 

1 service 

2 public class AccountService { 

3 Q@Autowired // 基 于 JPRA 的 Repository 类 
4 Private AccountRepository accountRepository7 
3 Public Account getBalanceByName (String name){ 
6 // 通 过 accountRepository 类 的 方法 查询 数据 库 信息 
8 
9 


return accountRepository.findByName (name); 
1 


第 四 ， 在 AccountRepository 类 中 ， 通 过 JPA 的 方式 从 Account 表 中 查询 余额 信息 ， 相 关 代码 
如 下 。 


1  @Component 

2 Public interface AccountRepository extends Repository<Account, Long>{ 
3 QQuery (value = "from Account s where s.name=:name") 

4 Account findByName (@Param("name") String name); 

Sy 


通过 第 3 行 的 注解 ， 我 们 指定 了 第 4 行 findByName 方法 对 应 的 SQL 语句 。 也 就 是 说 ， 通 过 
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这 个 方法 ， 我 们 能 从 Account 表 中 查询 参数 name 所 对 应 的 Account 信息 ， 其 中 包含 余额 信息 。 
而 Account 类 是 JPA 中 和 数据 表 对 应 的 Model 类 ， 相 关 代码 如 下 。 


上 


PPieoowanoum 上 wm 


0 
I 


// 省 略 必要 的 package 和 import 代码 
Q@Entity 
eTable (name="Account") // 指 定 该 类 和 Account 数据 表 相对 应 
public class Account { 
@Id // 通 过 eId 说明 name 字段 是 主键 
ecolumn (name = "name") // 通 过 ecolumn 注解 指定 和 数据 表 中 对 应 的 字段 
Private String name; 
@Column (name = "balance") 
Private String balance; 
// 省 略 针对 字段 的 get 和 set 方法 
有 


从 第 2 行 和 第 3 行 的 代码 中 , 我 们 能 看 到 该 类 是 和 Account 数据 表 相 对 应 的 ; 通过 第 6 行 和 第 
8 行 的 @Column 注解 ， 我 们 能 看 到 Account 类 中 的 name 和 balance 属性 与 Account 表 中 的 同名 字 
段 相 关联 ; 通过 第 5 行 的 @Id 注解 ， 我 们 能 看 到 name 字段 是 Accout 表 中 的 主键 。 

第 五 ， 在 application.yml 中 指定 这 个 项 目 所 需要 的 配置 信息 ， 相 关 代码 如 下 。 


o auwmwwNP 


Server: 
port: 2222 
spring: 
application: 
name: AccountService 
jpa: 
show-sql: true 
datasource: 
url: jdbc:mysql://localhost:3306/springboot 
username: root 
password: 123456 
driver-class-name: com.mysql.jdbc.Driver 
eureka: 
client: 
serviceUrl: 
defaultZone: http://localhost:8888/eureka/ 


在 第 2 行 中 ， 我 们 定义 了 AccountServiceProjRibbonl 项 目 运行 在 2222 端口 ， 需 要 注意 的 是 ， 
AccountServiceProjRibbon2 运行 在 2233 端口 。 通 过 第 8~12 行 代 码 ， 我 们 指定 了 JPA 连接 MySQL 
数据 表 的 配置 信息 。 通 过 第 13~16 行 代码 ， 我 们 把 这 个 提供 账户 查询 功能 的 Eureka 客户 端 注册 到 
Eureka 服务 器 上 。 

在 AccountServiceProjRibbonl 和 AccountServiceProjRibbon2 两 个 项 目 中 ，application.yml 文件 
第 5 行 指 定 的 spring.application.name 都 是 AccountService。 所 以 在 UIProj 项 目 中 ， 我 们 通过 Feign 
调用 AccountService 服务 时 ，Ribbon 组 件 会 把 请 求 以 负载 均衡 的 方式 均 摊 到 这 两 个 项 目 上 。 
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11.4 本 章 小 结 


本 章 给 出 了 三 个 案例 ， 在 第 一 个 案例 中 ， 大 家 能 看 到 Spring Boot 整合 Web 页 面 的 常见 做 法 ; 
在 第 二 个 案例 中 , 大 家 不 仅 能 看 到 微服 务 系统 中 的 各 种 安全 需求 , 还 能 看 到 针对 这 些 安 全 需求 的 具 
体 实现 方式 ， 第 三 个 案例 整合 了 诸多 组 件 ， 比 如 通过 Ribbon 实现 负载 均衡 、 通 过 Feign 封装 客户 
端 调用 的 方法 、 通 过 Hystrix 实现 “服务 失效 跳 转 ”的 效果 ， 最 终 诸多 案例 都 是 注册 到 Eureka 服务 
加 上 Es 


